The source for guide.truss.works.
The Trussel's Guide is important documentation and needs to be correct. Anybody from Truss should feel free to submit a pull request to change the guide. We use the CODEOWNERS file to keep track of who should review and merge PRs.
The guide is hosted on Github Pages. DNS is managed via the Truss AWS account. Merges to main deploy in a couple of minutes.
Github Pages acts like Jekyll, more or less.
The following methods will result in the site being available at http://localhost:4000. However, for small changes, it's easier to use Github's web editor.
If you have asdf configured , you can run the following:
asdf install
bundle install
bundle exec jekyll serveIf our dependencies become out of date, you'll need to update them. Here's an example where the version of octokit we were using was no longer available:
$ bundle install
Fetching gem metadata from http://rubygems.org/...........
Your bundle is locked to octokit (4.17.0), but that version could not be found in any of the sources listed in your Gemfile.
In this case, you'll need to update the dependency:
bundle update octokit