mirror of https://github.com/ansible/ansible.git
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
30 lines
1.3 KiB
Markdown
30 lines
1.3 KiB
Markdown
12 years ago
|
Homepage and documentation source for Ansible
|
||
|
|
=============================================
|
||
|
12 years ago
|
|
||
|
12 years ago
|
This project hosts the source behind [ansibleworks.com/docs](http://www.ansibleworks.com/docs/)
|
||
|
12 years ago
|
|
||
|
|
Contributions to the documentation are welcome. To make changes, submit a pull request
|
||
|
12 years ago
|
that changes the reStructuredText files in the "rst/" directory only, and Michael can
|
||
|
|
do a docs build and push the static files. If you wish to verify output from the markup
|
||
|
|
such as link references, you may [install Sphinx] and build the documentation by running
|
||
|
|
`make viewdocs` from the `ansible/docsite/latest` directory.
|
||
|
12 years ago
|
|
||
|
12 years ago
|
If you do not want to learn the reStructuredText format, you can also [file issues] about
|
||
|
|
documentation problems on the Ansible GitHub project.
|
||
|
12 years ago
|
|
||
|
12 years ago
|
Note that module documentation can actually be [generated from a DOCUMENTATION docstring][module-docs]
|
||
|
|
in the modules directory, so corrections to modules written as such need to be made
|
||
|
|
in the module source, rather than in docsite source.
|
||
|
12 years ago
|
|
||
|
|
Author
|
||
|
|
======
|
||
|
|
|
||
|
|
Michael DeHaan -- michael.dehaan@gmail.com
|
||
|
|
|
||
|
|
[http://michaeldehaan.net](http://michaeldehaan.net/)
|
||
|
|
|
||
|
12 years ago
|
[install Sphinx]: http://sphinx-doc.org/install.html
|
||
|
|
[file issues]: https://github.com/ansible/ansible/issues
|
||
|
|
[module-docs]: http://www.ansibleworks.com/docs/moduledev.html#documenting-your-module
|
||
|
|
|