Difference between revisions of "Glance-where-are-the-docs"
m (→"operator docs") |
m |
||
Line 38: | Line 38: | ||
* ''OpenStack Compute Administration Guide'' | * ''OpenStack Compute Administration Guide'' | ||
** content: installation and administration information | ** content: installation and administration information | ||
− | |||
− | |||
− | |||
** source files for glance related stuff | ** source files for glance related stuff | ||
*** doc/admin-guide-cloud/images | *** doc/admin-guide-cloud/images | ||
Line 52: | Line 49: | ||
** posted at: http://docs.openstack.org/image-guide/content/ | ** posted at: http://docs.openstack.org/image-guide/content/ | ||
− | == End User Guide | + | == End User Guide == |
− | * | + | * also generated from XML files in https://github.com/openstack/openstack-manuals |
− | + | ** source files for glance-specific stuff: | |
− | ** doc/ | + | *** doc/common/section_cli_glance_manage_images.xml |
− | ** doc/ | + | *** doc/common/section_sdk_glance_manage_images.xml |
+ | *** doc/common/section_getstart_image.xml ''(I can't figure out where this content is posted)'' | ||
* posted at: http://docs.openstack.org/user-guide/content/ | * posted at: http://docs.openstack.org/user-guide/content/ | ||
* file bugs at: http://bugs.launchpad.net/openstack-manuals | * file bugs at: http://bugs.launchpad.net/openstack-manuals | ||
<div style="margin-top:10ex"> | <div style="margin-top:10ex"> | ||
− | For other projects, see https://wiki.openstack.org/wiki/Documentation/Builds# | + | For other projects, see https://wiki.openstack.org/wiki/Documentation/Builds#Documentation_source_and_target_locations |
− | + | For general documentation project info, see https://wiki.openstack.org/wiki/Documentation | |
− | Also, join #openstack-doc on Freenode for real time answers to questions | + | Also, join #openstack-doc on Freenode for real time answers to questions. |
</div> | </div> |
Revision as of 21:30, 5 September 2014
This info is accurate as of 5 September 2014.
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
- audience: these are "prospective end user docs" that a cloud provider would use as the basis to create custom API docs for their particular cloud
- 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
- file bugs at: https://bugs.launchpad.net/openstack-manuals
- OpenStack Compute Administration Guide
- content: installation and administration information
- source files for glance related stuff
- doc/admin-guide-cloud/images
- doc/cli-reference/ch_cli_glance_property_keys.xml (suggested values for common image properties)
- doc/config-reference/image-service
- (may be some other stuff, and files are occasionally split/reorganized)
- posted at: http://docs.openstack.org/admin-guide-cloud/content/
- OpenStack Virtual Machine Image Guide (not glance-specific)
- content: how to obtain, create, and modify virtual machine images that are compatible with OpenStack
- source: doc/image-guide
- posted at: http://docs.openstack.org/image-guide/content/
End User Guide
- also generated from XML files in https://github.com/openstack/openstack-manuals
- source files for glance-specific stuff:
- doc/common/section_cli_glance_manage_images.xml
- doc/common/section_sdk_glance_manage_images.xml
- doc/common/section_getstart_image.xml (I can't figure out where this content is posted)
- source files for glance-specific stuff:
- posted at: http://docs.openstack.org/user-guide/content/
- file bugs at: http://bugs.launchpad.net/openstack-manuals
For other projects, see https://wiki.openstack.org/wiki/Documentation/Builds#Documentation_source_and_target_locations For general documentation project info, see https://wiki.openstack.org/wiki/Documentation Also, join #openstack-doc on Freenode for real time answers to questions.