Difference between revisions of "Glance-where-are-the-docs"
m (→API Quick Reference Docs) |
m |
||
| Line 1: | Line 1: | ||
This info is accurate as of 1 August 2013. | This info is accurate as of 1 August 2013. | ||
| − | Info about contributing to the documentation is here: https://wiki.openstack.org/wiki/Documentation | + | Info about contributing to the documentation is here: https://wiki.openstack.org/wiki/Documentation (basically, you clone a repo and use gerrit just like you do for code) |
| + | |||
<div style="background-color: yellow"> | <div style="background-color: yellow"> | ||
Note to Glance devs: file a bug when you plan to contribute to/update documentation so there's no duplication of effort. | Note to Glance devs: file a bug when you plan to contribute to/update documentation so there's no duplication of effort. | ||
Revision as of 20:34, 1 August 2013
This info is accurate as of 1 August 2013.
Info about contributing to the documentation is here: https://wiki.openstack.org/wiki/Documentation (basically, you clone a repo and use gerrit just like you do for code)
Note to Glance devs: file a bug when you plan to contribute to/update documentation so there's no duplication of effort.
Contents
"dev docs" written for Python developers by developers working on glance
- generated from the rst files in the doc/source directory in the source code
- posted at:
- content: should contain information for contributors to the Glance project itself
- file bugs at:
"API docs" written for application developers and people who upload images programmatically
- generated from files in https://github.com/openstack/image-api
- v1 generated from XML files in openstack-image-service-api/src/docbkx
- v2 generated from markdown files in openstack-image-service-api/src/markdown
- content: the API specifications
- file bugs at: http://bugs.launchpad.net/openstack-api-site
API Quick Reference Docs
- generated from XML files in: https://github.com/openstack/api-site
- posted at: http://api.openstack.org/api-ref.html
- content: quick ref docs and WADLs for the API
- file bugs at: http://bugs.launchpad.net/openstack-api-site
"operator docs"
- generated from XML files in https://github.com/openstack/openstack-manuals
- for glance:
- doc/src/docbkx/common/adding-images.xml
- doc/src/docbkx/common/ch_image_mgmt.xml
- doc/src/docbkx/common/image-formats.xml
- (may be some other stuff, and files are occasionally split/reorganized)
- posted at: http://docs.openstack.org/grizzly/openstack-compute/admin/content/
- content: installation and administration information
- file bugs at: https://bugs.launchpad.net/openstack-manuals
End User Guide (formerly, the "quickstart" guide)
- generated from XML files in https://github.com/openstack/openstack-manuals
- doc/src/docbkx/cli-guide/src/glance_cli_commands.xml
- doc/src/docbkx/cli-guide/src/glance_cli_howto.xml
- posted at: http://docs.openstack.org/user-guide/content/
- file bugs at: http://bugs.launchpad.net/openstack-manuals
