All of this documentation is open source and available to edit on GitHub. If you see something that you can contribute, submit a pull request with your edits! To make this easy you can click the "Edit this page" link at the top of the web docs.
The docs are all written in GitHub Flavored Markdown. If you've used GitHub, it's pretty likely you've encountered it before. You can become a pro in a few minutes by reading their GFM Documentation page.
You'll notice that the GitHub Repo is in a logical structure. Each of the major sections is a folder. For example the 'Reference: Basemap' pages are in the folder
basemap in the top level of the repository.
Some of the chapters are split into multiple sections to help break up the content and make it easier to digest. You can easily see how chapters are laid out by looking at the
SUMMARY.md file. This convention helps keep chapters together in the file system and easy to view either directly on github or gitbook.
Table of Contents
You'll find the table of contents in the SUMMARY.md file. It's a nested list of markdown links. You can link to a file simply by putting the filename (including the extension) inside the link target.
This is the root README.md file. It's intent is to give the reader an elevator pitch of what this document is about is and why we think it is useful.
Send a Pull Request
So that's it. You make your edits, keep your files and the Table of Contents organized, and send us a pull request.
Enjoy the Offline Docs
Moments after your edits are merged, they will be automatically published to the web, as a downloadable PDF, .mobi file (Kindle compatible), and ePub file (iBooks compatible).