- Git
- Sphinx or check the Sphinx Github Repository
- Python (for using Sphinx)
- Pip (for using/installing Sphinx)
- Text editor such as Atom, Notepad++, or SublimeText.
- Terminal/Powershell access (iTerm2, Terminal.app, etc.)
- Git Desktop client (if you prefer a GUI instead of a shell prompt). Suggested applications would be Github Desktop Client, Sourcetree, or Tower (Mac OS X Only).
- If you've never obtained the documentation before you'll want to clone the repository. The default branch is
master
, this is good.$ [email protected]:DockDogs/MyDockDogsDashboard.git
- If you've already cloned the repository navigate to where this is in your computer using Terminal or Powershell. Once in this directory you'll be able to execute the following:
$ git fetch && git checkout master
- Edit files in
docs
folder using a text editor such as Atom, SublimeText, or Notepad++. - Files are written in
reStructuredText
syntax.
$ git commit -am "commit message documenting what you've changed"
$ git push
- Once pushed to
master
branchTravis-CI
will attempt to compile the documentation via a combination of wizardry and science. - If Travis-CI is satisfied that the build compiles properly it will send it for compiling and deployment at ReadTheDocs
- Confirm updates are live & accessible via accessing http://help.dockdogs.com. This may take a few minutes to fully deploy, please be patient. Check the
Travis-CI
page &ReadTheDocs
build pages linked above.
- Copyright 2015-2016, All Rights Reserved - DockDogs Worldwide.