This app is publicly available primarily for the sake of transparency, but there is very little code in here specific to practicingruby.com, so we definitely want to generalize it eventually. Do feel free to email firstname.lastname@example.org with any questions you have about this app.
To find out more about Practicing Ruby visit practicingruby.com.
Practicing Ruby is a Ruby on Rails 3.2 application which runs on Ruby 1.9.2+ and PostgreSQL databases. Other databases like MySQL or SQLite are not officially supported.
Setting Up a Development Copy: Step by Step
To install a development version of Practicing Ruby, follow these steps:
- Fork our GitHub repository: http://github.com/elm-city-craftworks/practicing-ruby-web
- Clone the fork to your computer
- If you don't already have bundler installed, get it by running
gem install bundler
bundle installto install all of the project's dependencies
- Finally, run
rake setupto create the required config files, create the database, and seed it with data
To make things even easier, you can copy and paste this into your terminal once you've got the project cloned to your computer
gem install bundler bundle install bundle exec rake setup
To run a Rails server, a delayed job worker, and Mailcatcher, type the following command:
$ foreman start
You can access the Rails application on port 3000, and the Mailcatcher instance on port 1080.
Setting Up a Production-Like Environment with Chef
Our Practicing Ruby Chef cookbook fully automates the process of setting up a production-like environment that can run the Practicing Ruby Rails app. It takes a bare Ubuntu system from zero to the point where Practicing Ruby can be deployed with Capistrano. Check out the cookbook's README to learn more.
Features and bugs are tracked through Github Issues.
Contributors retain copyright to their work but must agree to release their contributions under the Affero GPL version 3.
If you would like to help with developing Practicing Ruby, just file a ticket in our issue tracker and we will find something to keep you busy.
Submitting a Pull Request
- If a ticket doesn't exist for your bug or feature, get in touch with us
- Create a ticket describing your idea or fix
- Don't start working on your patch until you've heard back from a maintainer
- We are being very picky about what features we're going to support, and it breaks our hearts when we need to turn away perfectly good patches. So please reach out to us first
- Fork the project
- Create a topic branch
- Implement your feature or bug fix
- Add documentation for your feature or bug fix
- Add tests for your feature or bug fix
rake testIf your changes are not 100% covered, go back to step 6
- If your change affects something in this README, please update it
- Commit and push your changes
- Submit a pull request
Practicing Ruby is released under the Affero GPL version 3.
If you wish to contribute to Practicing Ruby, you will retain your own copyright but must agree to license your code under the same terms as the project itself.
Practicing Ruby - an Elm City Craftworks project