Notes for site maintenance

_tl;dr_ document that summarizes notes on the structure and maintenance of this site.

Bootstrap, Bootswatch, and styling

- Build on Twitter Bootstrap

- Styling based on Bootswatch's "Darkly" theme

- Custom modifications to defaults from Bootstrap and Bootswatch are stored in `/stylesheets/bootstrap.scss`

- Jekyll builds Bootstrap, Bootswatchm and custom modifications manually on every build. We don't use a pre-build release CSS file.

- Bootstrap and Bootswatch files are spread across 3 different directories. In all cases, the files are unmodified from the versions found in official releases.

- `/_sass/`

- `/_sass/bootstrap/`: Core Bootstrap Sass styles. New copies can be found in official releases under `bootstrap-sass-<version>.zip/bootstrap-sass-<version>/assets/stylesheets/`.

- `/_sass/_bootswatch.scss`: Bootswatch's functional changes to Bootstrap styling. Can be found on the Bootswatch website or GitHub repo.

- `/_sass/_variables.scss`: Bootswatch's coloring and other visual styles. Can be found on the Bootswatch website or GitHub repo.

- `/javascripts/bootstrap/`: Bootstrap JavaScript helpers. Found in `bootstrap-sass-<version>.zip/bootstrap-sass-<version>/assets/javascripts/`.

- `/fonts/bootstrap`: Bootstrap font files. Found in `bootstrap-sass-<version>.zip/bootstrap-sass-<version>/assets/fonts/bootstrap`.

- File structure here is different from Bootstrap's `assets` directory because we need to have a separate `sass_dir` that contains all our partials.

- If updating to a new version of any of these dependencies, make sure that no variable names have changed -- we override some key variables.

- Always upgrade all of the Bootstrap files and all of the Bootswatch files at the same time, and keep their versions matching.