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 or actively maintained by Hashrocket. Thanks to all of our contributors!
This Rails application is now in production and actively maintained by Dillon Hafer
If you are creating your own version of the site, fork the repository.
Then, follow these setup steps:
$ git clone https://github.com/dillonhafer/hr-til
$ cd hr-til
$ bundle
$ cp .env{.example,}
$ rails db:setup
$ bin/devIn 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: "friend@whitelist.com"Ensure you have set the google client id and google client secret via Oauth instructions.
Run all tests with:
$ rake
- The gem
selenium-webdriverdepends on the Firefox and/or Chrome browsers.
basic_auth_credentials both toggles and defines basic authentication:
# .env
basic_auth_credentials: username:passwordslack_post_endpoint allows the app to post to Slack:
# .env
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.
cp .env.example .env.production
ansible-playbook -i til.dillonhafer.com, config/digital-ocean-ansible.yml
mina setup
mina deploy
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.