ansible/docs/docsite/README.md

22 lines
1.7 KiB
Markdown
Raw Normal View History

Homepage and documentation source for Ansible
=============================================
2012-10-08 11:44:38 +00:00
2014-01-28 16:38:52 +00:00
This project hosts the source behind [docs.ansible.com](http://docs.ansible.com/)
2012-10-08 11:44:38 +00:00
Contributions to the documentation are welcome. To make changes, submit a pull request that changes the reStructuredText files in the `rst/` directory only, and the core team can do a docs build and push the static files.
2013-12-24 22:23:38 +00:00
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` directory.
2013-12-24 22:23:38 +00:00
To include module documentation you'll need to run `make webdocs` at the top level of the repository. The generated html files are in `docsite/htmlout/`.
2012-10-08 11:44:38 +00:00
To limit module documentation building to a specific module, run `MODULES=NAME make webdocs` instead. This should make testing module documentation syntax much faster. Instead of a single module, you can also specify a comma-separated list of modules. In order to skip building documentation for all modules, specify non-existing module name, for example `MODULES=none make webdocs`.
If you do not want to learn the reStructuredText format, you can also [file issues] about documentation problems on the Ansible GitHub project.
2012-10-08 11:44:38 +00:00
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.
2012-10-08 11:44:38 +00:00
2013-12-24 22:23:38 +00:00
To install sphinx and the required theme, install pip and then "pip install sphinx sphinx_rtd_theme"
[file issues]: https://github.com/ansible/ansible/issues
2014-01-28 16:38:52 +00:00
[module-docs]: http://docs.ansible.com/developing_modules.html#documenting-your-module