Publishing Jazzy Docs to GitHub.io

1. Install the latest version of Jazzy with gem install jazzy.
2. Run pod install to ensure the Pods project is up to date.
3. Ensure you are at the root directory of the repo.
4. Ensure that all Jazzy configurations in .jazzy/*.yml are updated with the current SDK version.
5. Run Scripts/build_api_docs.sh <library name> <library name> ... to generate Jazzy docs for all the libraries that are published. This step also generates a new index.html page which has a link to ONLY the libraries you just generated. So if you only generated updated docs for one existing library, DO NOT replace the index.html page in step 9.
6. Run git checkout gh-pages to check out the gh-pages branch.
7. Run rm -rf Azure* to delete all top-level documentation directories. This ensures that we delete the docs for types that have been removed since the last publish.
8. Run mv build/jazzy/* . to move all the new docs and the new index.html page into the root of the repo.
9. Run git add <library name> <library name> ... to stage all the new docs. If you are updating the index.html page, also add that with git add index.html.
10. Run git commit --amend --no-edit to amend the ONE AND ONLY docs commit in the gh-pages branch. Do NOT add a new commit. This prevents the repo size from growing significantly due to storing all old revisions of the docs site.
11. Run git push upstream gh-pages --force to push the new docs. The docs site will automatically be rebuilt and should be live within a minute or so.