TIL is an open-source project by the team at Hashrocket that catalogues the sharing & accumulation of knowledge as it happens day-to-day. Posts have a 200-word limit, and posting is open to any Rocketeer as well as select friends of the team. We hope you enjoy learning along with us.
This site was open-sourced as a window into our development process, as well as to allow people to experiment with the site on their own and contribute to the project.
Today I Learned was ported to Elixir/Phoenix in 2017 (source code), and the Rails application is no longer in production as a Hashrocket project. We still plan to respond to issues and merge pull requests. Thanks to all of our contributors!
If you are creating your own version of the site, fork the repository.
Then, follow these setup steps:
$ git clone https://github.com/hashrocket/hr-til
$ cd hr-til
$ gem install bundler
$ bundle install
$ cp config/application.yml{.example,}
$ rake db:create db:migrate db:seed
$ rails s
In development, db:seed
will load sample data for channels, developers, and
posts. Omit this command to opt-out of this step, or create your own sample
data in db/seeds/development.rb
.
Authentication is managed by Omniauth and Google. See the omniauth-google-oauth2 README and Google Oauth 2 docs for setup instructions. To allow users from a domain, multiple domains, or a specific email to log in, set those configurations in your environmental variables:
# config/application.yml
permitted_domains: 'hashrocket.com|hshrckt.com'
permitted_emails: '[email protected]'
Ensure you have set the google client id and google client secret via Oauth instructions.
Once set, visit '/admin' and log in with a permitted email address or domain.
Run all tests with:
$ rake
Or, run all the test in parallel with flatware:
$ flatware fan rake db:test:prepare
$ flatware rspec && flatware cucumber
- The gem
selenium-webdriver
depends on the Firefox browser. - The gems
flatware-rspec
andflatware-cucumber
require ZeroMQ. Learn more here.
Staging and production instances are located here:
basic_auth_credentials
both toggles and defines basic authentication:
# config/application.yml
basic_auth_credentials: username:password
slack_post_endpoint
allows the app to post to Slack:
# config/application.yml
slack_post_endpoint: /services/some/hashes
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
Bug reports and pull requests are welcome on GitHub at https://github.com/hashrocket/hr-til. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
We love seeing forks of Today I Learned in production! Please consult our usage guide for guidelines on appropriate styling and attribution.
TIL is released under the MIT License.
TIL is supported by the team at Hashrocket, a multidisciplinary design and development consultancy. If you'd like to work with us or join our team, don't hesitate to get in touch.