To generate the user guide website locally to test OSS doc changes, run the following commands from the finagle directory. Note that you'll need to build Finagle's dependencies with dodo and install Sphinx on your system before you can build the site locally.

$ ./sbt finagle-doc/makeSite
$ open doc/target/site/index.html

To publish a new version of the user guide to GitHub Pages:

1. Make sure SBT sees the current version as the release version of
   Finagle (and not the SNAPSHOT version) by running from the master branch.
2. Execute the script `finagle/pushsite.bash`.