37 Commits

Author SHA1 Message Date
Richard Theis
1a2e12832d Devref: Command Beta
The devref proposes OSC support for beta commands.

Change-Id: I538a38be33734faf6eb69a3cb50946b2396b0c57
2016-04-21 12:14:42 -05:00
Dean Troyer
baf96411fe Clean up for next release
* Release notes
* Docs Table of Contents

Change-Id: I4bef26ed348923671a2b50f90606661d519b40e3
2016-04-18 14:19:27 -05:00
Dean Troyer
3d6b072111 Add doc describing how to handle API errors
Include the following scenarios:
* general external errors
* a command with multiple API calls

Change-Id: Ie5c4b775e11898bacf2156a34457f5397fd2c891
2016-03-11 13:35:41 -06:00
Jenkins
f4ad41761a Merge "Doc: Add optional command specs process" 2016-02-04 20:27:18 +00:00
Jenkins
5aeb831157 Merge "Use Block Storage instead of Volume" 2016-01-04 16:23:30 +00:00
Richard Theis
7b110511d2 Doc: Add optional command specs process
The developer documentation has been updated to include an
optional command specs process. This process may be used
to work out the specifications for new commands, objects
and actions before their implementation.

This new process could assist in the implementation of
additional neutron support in OSC.

Change-Id: I62f7472435a9caacee0d1b4c8d35417c123b5a44
2015-12-14 08:40:30 -06:00
Steve Martinelli
727792da17 autodocument commands from plugins using stevedore.sphinxext
conflicting command names are a painpoint, so is manually updating
a list. let's autodocument the commands that are being use by
existing osc supporters.

Change-Id: If37d81dfd57cc79803668b64be1ccd776e319572
2015-12-01 01:23:56 -05:00
Steve Martinelli
43fbe569a5 Add a changelog to see all changes into tagged releases
in addition to release notes, it'll be nice to also see the
changelog that happened between releases.

Change-Id: I4548be22c377ec12f0398a248391384126506715
2015-11-30 16:30:42 -05:00
Jenkins
78a7eaae0b Merge "Add command wrapper doc" 2015-11-30 10:28:28 +00:00
Xi Yang
54b0ef3358 Use Block Storage instead of Volume
Volume is better to be replaced by Block Storage in the
doc.

Change-Id: I736669ee01c7385b6e701cb20f4334eff1c49286
2015-11-27 17:56:10 +08:00
Xi Yang
32e0ed6980 Change 'Object Store' to 'Object Storage'
Because the official documents uses 'Object Storage',
so change it in this project.

Change-Id: I87c0996b48c452b3ff619b8214676ae377e6d0af
2015-11-26 16:35:54 +08:00
Dean Troyer
5e46176540 Add command wrapper doc
This is a follow-up to I6c750730963615895f5d9953487d2d5a905885a8 that
removed a command deprecation warning wrapper.  This documents the
technique for later use.

Change-Id: Ieaa1e6b7eed4e5b037b4bfb6cf488e1290fc69f7
2015-11-20 15:23:14 -06:00
Dean Troyer
46fdaaba6b Add Command Options guideline doc
Add a developer guideline for command options to define the options
used across multiple commands and make them behave consistently.

Change-Id: I1dbbafe8061e10b271cd55cac056731508c52204
2015-10-21 09:20:00 -05:00
Steve Martinelli
d833d377cb Add developer documentation
OSC was missing developer docs, these are critically helpful for
new developers. Add sections related to running tests (tox,
functional and with the debugger), and generating docs locally.

implements bp: developer-documentation
Change-Id: I428d89c3e5fc335864bc4f7843506043ec332fe5
2015-08-08 08:32:03 +00:00
Jens Rosenboom
bf99218292 Add a reference to the IRC channels
As the name of the associated IRC channel for this project is not
completely obvious, add a reference to the doc index page so that
it may be found easier.

Change-Id: I6cb6e2571bff73db6d983cd96fe6d03319d6577c
2015-06-03 02:53:50 +02:00
Steve Martinelli
f815b3fe27 Add a doc that dictates backwards incompatible changes
start tracking any changes in a standard format, so users may
have a heads up about any impacts.

Change-Id: Ibc06926a53592e927d11440362cd3598e0d4b2bf
Closes-Bug: 1406470
2015-04-23 23:25:09 -04:00
Dean Troyer
6e7013954d Begin documenting --os-cloud
Change-Id: Id2e98ac5601840f6d380cabcd578f1a6d6d9b245
2015-04-18 23:04:53 -05:00
Steve Martinelli
98aee9e39a Create 1.0.2 release notes
Also move the release notes to the bottom of the ToC, no need for
it to be at the top, that's prime real estate.

Change-Id: Ib3094a390a7214b320d02f77229f368aa4432c4e
2015-01-19 10:42:29 -06:00
Jenkins
454c19e58d Merge "Copy HIG from wiki" 2015-01-15 06:27:55 +00:00
Dean Troyer
558e39aa27 Copy wiki content to index page
Copy the content from the main wiki page that is not covered
elsewhere in these docs to the index page.

Change-Id: I94b68b7a0117d08fc8aba961c6de728118ef794e
2015-01-13 22:13:58 -06:00
Dean Troyer
37eda86099 Copy HIG from wiki
This is a basic port of the Human Interface Guide from the OpenStack
wiki to our docs.  Content changes for updating, etc, will follow
in a separate review.

Change-Id: Id031cd6a27e045b249e16d00e41be24c55fb3c29
2015-01-13 17:06:41 -06:00
Jenkins
95b1853396 Merge "Workflow documentation is now in infra-manual" 2014-12-06 00:15:58 +00:00
Jeremy Stanley
1dc0e2b552 Workflow documentation is now in infra-manual
Replace URLs for workflow documentation to appropriate parts of the
OpenStack Project Infrastructure Manual.

Change-Id: Id09c9bdf8804c1ed90e49606e76ffbff1d96a7c2
2014-12-05 03:30:40 +00:00
Dean Troyer
625a8ae42d Add documentation of interactive mode
This is a light description with some examples.

Change-Id: Iff9ad904a150f2bb7673bd4106cf26bcefec08b9
2014-12-04 15:16:05 -05:00
Jenkins
1989198eac Merge "Enhance the theming for modules page" 2014-12-01 23:06:53 +00:00
Dean Troyer
254910d3ce Begin copying wiki command list here
* Sort by command objects
* Drop the comparison to the project CLIs
* Minor updates to command help to match docs

Initially include the cross-API commands to establish the structure and format.

Change-Id: I77a7b3c89e088b66aa62941e29ce0b65b532285b
2014-11-19 14:47:53 -06:00
Steve Martinelli
6dc128636e Enhance the theming for modules page
Also fixes a few small docstring syntax errors

Change-Id: I85eb968e32c1191cf5d60d02deff2ab7f3291074
2014-11-18 22:07:57 -05:00
Dean Troyer
0d56d0178b Add authentication description doc
This is represents the current operation

Closes-Bug: #1337422

Change-Id: I8092e7723b563647e13b6e2f0b7901a16572b6c7
2014-11-17 14:21:03 -05:00
Anita Kuno
92add18e31 Acknowlege git.o.o as OpenStack's git server
OpenStack's cannonical git server is at git.o.o this patch
updates the index.rst to reflect that.

Change-Id: I54eeea7fab2e0f64ca9f23f7c328e2ff19721a41
2014-09-18 17:06:29 -04:00
Dean Troyer
f7357b7fe7 Update docs and release notes for 0.4.1 release
Closes-Bug: 1365505
Change-Id: I027d263ba9980715454b034a37733c5ff23fd169
2014-09-08 11:36:33 -05:00
Dean Troyer
3fa5fa5ba7 Update docs and release notes for 0.4.0
Change-Id: Iad6cfe5dee63adb9e60a0ea9811217b3175eb99c
2014-06-20 12:15:52 -05:00
Dean Troyer
4f1ebe8069 Update docs for plugins and release notes
* Fill out the existing command and man page
* Add a plugins page.
* Begin the release notes for 0.3.0

Change-Id: I4527fed28a10a9d79fc8f6c1d925a4bf0d0a7a36
2013-12-05 17:29:35 -06:00
Dean Troyer
0507e9cf6f Add release notes in docs
Change-Id: I49dc936a37848745ce3412e810b98348558d1157
2013-08-06 12:43:22 -05:00
Dean Troyer
6f9dcc13f6 Prep for 0.2 release (0.2.rc1)
* rename HACKING to HACKING.rst and refer to the common OpenStack HACKING file
* add the barest of pointers to the wiki, etc. to the source docs
* add a bare-bones man page

Change-Id: I80e5b972af645f14ef17ae87f182ab09cb08dabe
2013-08-01 16:21:22 -05:00
Lorin Hochstein
1a5aabf6fc Fixed a typo in the rst docs.
Change-Id: Ie3484f8fe0a63ff5a6815f3ec440adf7dc5d9482
2012-06-26 16:57:33 -04:00
Clark Boylan
3dceacf6cd Update Contributing blurb in the docs.
Contributing blurb previously mentioned social coding and Github.
The OpenStack contribution workflow is slightly different. Provide
details on Github, LP, and Gerrit.

Change-Id: Ie5ecd25e5828de611561f37b3acbccc5cf3f0d04
2012-06-22 10:24:44 -07:00
Clark Boylan
77e5ce57fd Move docs to doc.
To better facilitate the building and publishing of sphinx
documentation by Jenkins we are moving all openstack projects with
sphinx documentation to a common doc tree structure. Documentation
goes in project/doc/source and build results go in project/doc/build.

Change-Id: I925e687254bac9e06c2c520f4fc35a083e21c4ca
2012-06-11 14:37:48 -07:00