Add instructions about how to update documentation to documentation
This commit is contained in:
parent
4c00f6dc37
commit
2ce6c8eac0
|
@ -0,0 +1 @@
|
||||||
|
site/
|
|
@ -0,0 +1,39 @@
|
||||||
|
# Documentation
|
||||||
|
|
||||||
|
In addition to the code for farmOS 2.x, this repository includes the source files of the
|
||||||
|
documentation which is hosted at [http://2x.farmos.org](http://2x.farmos.org).
|
||||||
|
|
||||||
|
It uses [mkdocs](http://www.mkdocs.org) to convert simple markdown files into
|
||||||
|
static HTML files.
|
||||||
|
|
||||||
|
To get started contributing to the farmOS 2.x documentation, fork
|
||||||
|
[farmOS](https://github.com/farmOS/farmOS/tree/2.x) on Github. Then install mkdocs and
|
||||||
|
clone this repo:
|
||||||
|
|
||||||
|
$ brew install python # For OSX users
|
||||||
|
$ sudo apt-get install python-pip # For Debian/Ubuntu users
|
||||||
|
$ sudo pip install mkdocs mkdocs-bootstrap mkdocs-bootswatch
|
||||||
|
$ git clone https://github.com/farmOS/farmOS.git farmOS
|
||||||
|
$ cd farmOS
|
||||||
|
$ git checkout 2.x
|
||||||
|
$ git remote add sandbox git@github.com:<username>/farmOS.git
|
||||||
|
$ mkdocs serve
|
||||||
|
|
||||||
|
Your local farmOS 2.x documentation site should now be available for browsing:
|
||||||
|
http://127.0.0.1:8000/. When you find a typo, an error, unclear or missing
|
||||||
|
explanations or instructions, hit ctrl-c, to stop the server, and start editing.
|
||||||
|
Find the page you’d like to edit; everything is in the docs/ directory. Make
|
||||||
|
your changes, commit and push them, and start a pull request:
|
||||||
|
|
||||||
|
$ git checkout -b fix_typo # Create a new branch for your changes.
|
||||||
|
... # Make your changes.
|
||||||
|
$ mkdocs build --clean; mkdocs serve # Go check your changes.
|
||||||
|
$ git diff # Make sure there aren’t any unintended changes.
|
||||||
|
...
|
||||||
|
$ git commit -am "Fixed typo." # Useful commit message are a good habit.
|
||||||
|
$ git push sandbox fix_typo # Push your new branch up to your Github sandbox.
|
||||||
|
|
||||||
|
Visit your fork on Github and start a Pull Request.
|
||||||
|
|
||||||
|
For more information on writing and managing documentation with mkdocs, read the
|
||||||
|
official mkdocs documentation: [http://www.mkdocs.org](http://www.mkdocs.org)
|
|
@ -17,6 +17,7 @@ nav:
|
||||||
- Debugging: development/environment/debug.md
|
- Debugging: development/environment/debug.md
|
||||||
- Automated tests: development/environment/tests.md
|
- Automated tests: development/environment/tests.md
|
||||||
- Coding standards: development/environment/code.md
|
- Coding standards: development/environment/code.md
|
||||||
|
- Documentation: development/environment/documentation.md
|
||||||
- Module:
|
- Module:
|
||||||
- Fields: development/module/fields.md
|
- Fields: development/module/fields.md
|
||||||
- OAuth: development/module/oauth.md
|
- OAuth: development/module/oauth.md
|
||||||
|
|
Loading…
Reference in New Issue