Railroady & Contributing to Open Source

My Talk for the Rails Girls Atlanta 3/26/2014 Meetup, based on my experiences with the Railroady gem.

Transcript

1. RailRoady Gem & Contributing to Open Source kylie stradley @kyfast github.com/kyfast
2. who’s this lady? can she be trusted? Kylie Stradley Georgia Tech Grad Ruby on Rails Intern @ Big Nerd Ranch Cat owner
3. Trustworthy did not lie about the cat
4. –Preston Lee, maintainer of RailRoady RailRoady is a dirt simple gem for UML diagram generation on Rails 3/4 projects, capable of analyzing your existing models and controllers. It rocks!
5. Database Schema “Active Record knows how to update your schema, bringing it from whatever point it is in the history to the latest version. Active Record will also update your db/ schema.rb file to match the up-to-date structure of your database.”
6. Model Relationships
7. Controller Relationships
8. –Preston Lee, maintainer of RailRoady RailRoady is a dirt simple gem for UML diagram generation on Rails 3/4 projects, capable of analyzing your existing models and controllers. It rocks!
9. how to get RailRoady
10. What do I have now?
11. not so fast Currently, you need to manually create doc folder in application root folder Only available for Mac or Linux operating systems only for Rails 3 & 4, earlier Rails projects can use “RailRoad” gem
12. can be useful when… you’ve cobbled together Frankenstein’s monster of an app you’re new to an existing (& possibly complicated) app you’re just someone who likes diagrams
13. someone fixed it! Currently, you need to manually create doc folder in application root folder Only available for Mac or Linux operating systems only for Rails 3 & 4, earlier Rails projects can use “RailRoad” gem
14. It was me, It could be you too!
16. If someone’s not already on it
17. check the issues
18. Fork it! & clone to your desktop
19. Fix & Push
20. Submit a Pull Request
21. Success!
22. any way you slice it get merged get rejected, but maybe they’ll tell you why maybe they’ll never look at it ever
23. Gem Source: https://github.com/preston/railroady ! Gem Documention: http://railroady.prestonlee.com/ ! Rails Documentation on Active Record(Slide 5): http://guides.rubyonrails.org/active_record_basics.html ! RailsCast on Contributing to Open Source: http://railscasts.com/episodes/300-contributing-to-open-source