Commit Graph

20 Commits

Author SHA1 Message Date
Stephen Finucane 52cdbd271e docs: Update docs to reflect deprecation status
Change-Id: I56b862305b31916cef143494050e5e08b1ac70b1
Signed-off-by: Stephen Finucane <stephenfin@redhat.com>
2022-04-06 14:18:05 +01:00
Akihiro Motoki 6c0e4d7a39 PDF documentation build
Also reorganizes the document structure to match both HTML and PDF docs.

Story: 2006100
Task: 35143

Change-Id: Ie3f38e2ecf52e6a6cbd52bb36196e6f589f1ca0f
2019-10-11 03:51:38 +09:00
Andreas Jaeger acef73c9bd Update api-ref location
The api documentation is now published on docs.openstack.org instead
of developer.openstack.org. Update all links that are changed to the
new location.

Note that redirects will be set up as well but let's point now to the
new location.

For details, see:
http://lists.openstack.org/pipermail/openstack-discuss/2019-July/007828.html

Change-Id: I53120e2ff3ae337a55c4cd0904bc9ad1dd54d082
2019-07-22 20:52:18 +02:00
chenxing 6ea7b506ca Tiny fix of documentation
Change-Id: Ida6e6ec6919e4c2303200ff66fdc0a094c7d90d1
2019-05-07 11:54:52 +08:00
Stephen Finucane e11efd8d76 doc: Create directory structure for docs migration
The spec [1] recommends the following sections:

- install
- contributor
- configuration
- cli
- admin
- user
- reference

Only a few of these are useful here:

- contributor
- cli
- user
- reference

Add these and populate them.

[1] specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration

Change-Id: I8a9ddcc915f25ebfaa1e994dba6c15883bd2715d
2017-07-12 15:07:35 +01:00
Simon Leinen 0010ab79b4 Update Compute API Guide pointer
Since the description of the individual API calls have been moved to
the API Reference, the API Guide is more or less what the "overview"
in the original guide was.  Therefore I just pointed to the guide, and
removed the phrase "-- the overview, at least --".

Change-Id: I8b1cb6a7ea4469a91f0dfe69d26f4ffec178ed43
Closes-Bug: 1678591
Signed-off-by: Simon Leinen <simon.leinen@gmail.com>
2017-04-02 13:03:27 +02:00
Matt Riedemann 2a622fff47 Update docs for instructions on deprecating commands
The instructions for deprecating commands predated reno
so this change updates them a bit to be current with our
processes now. Also adds a reminder to update the help
text/description of a command to mark it deprecated.

Change-Id: I530399ba9cf6c50bd0dbb06f231aee61466eebd6
2016-10-12 19:12:51 -04:00
Matt Riedemann f3fef4ab2f Change future nova version number references based on new values
The nova server liberty version is changing from 2015.2 to 12.0.0 and
the 2016.1 'M' release will be 13.0.0 so update the deprecation warnings
in the docs and code using those versions.

Depends on nova change 192406.

Change-Id: I6a35fa0dda798fad93b804d00a46af80f08d475c
2015-06-17 14:26:19 -07:00
Joe Gordon 4e9a2b4c69 Fix all doc warnings and gate on warnings
* Remove releases (File removed in e334096aa3)
* Add link to man page
* Fix some docstring formatting

Change-Id: Iec67a6d32f0365e514394c1e3eb7d8e4ae6aff65
2015-06-04 17:10:50 +09:00
Matt Riedemann 3502c8aee2 Add documentation on command deprecation process
Since we haven't removed deprecated commands before, add some
documentation to the devref on the process for this type of change.

Change-Id: Iff6f5df372bec524757b84747c7a95bbf6412c35
2015-06-02 14:14:11 -07:00
Andrey Kurilin 0a60aae852 Rename v1_1 to v2
Module novaclient.v1_1 is used as implementation of V1.1, V2 and V3.
Since future development(microversioning) will be done across V2,
implementation should be done in appropriate module(to prevent misleading).

Despite the fact that implementation for all versions are equal, discover
method for contrib path worked only for v1.1. This patch fixes this bug and
modifies shell tests to check all versions.

Change-Id: Ib6798f4dfe177586302141f522dc593560ce6a5b
2015-02-04 17:40:46 +02:00
Jeremy Stanley c4233cfd2a Workflow documentation is now in infra-manual
Replace URLs for workflow documentation to appropriate parts of the
OpenStack Project Infrastructure Manual.

Change-Id: I75618aaf9e07324985a83ca74d35bcab59e186c1
2014-12-05 03:30:40 +00:00
Andrey Kurilin 3f64b4577b Propose 'tox' as tests launcher
Since ``tox`` is used as launcher in gates, it should be mentioned in docs
instead of ``python setup.py test``.

Change-Id: Ie5fcd9da755e1146b2b042fa5906aa28748980a6
2014-10-23 14:47:32 +03:00
JUN JIE NAN 77fe828870 Added v3 interfaces in reference doc
Added hosts, agents, flavors and so on into reference doc

Change-Id: I32198a0e65551f6ea3c67b72a8d7c6dff7da9f91
2014-01-03 13:57:56 +08:00
JUN JIE NAN 3582d6f1be Generate interfaces reference doc
Add gen_ref in conf.py to generate reference doc to avoid maintaining
these boilerplates.

Change-Id: I6683c41d39685dcb7f7a619a36210a987c9e9825
2014-01-03 13:51:08 +08:00
Monty Taylor c7e62d4c57 Clean up a little cruft
OpenStack runs a git service now, so instead of linking to github URLs,
link to git.openstack.org.
Versions for pbr in setup.py actually wind up being an error (and a very
odd one) Remove them.
The setup hook in setup.cfg is no longer needed.

Change-Id: I8f48ac194e6c01e9bb06fa5df6f2b2bf28c01636
2013-09-20 16:02:48 -07:00
Jenkins 20aa3ab779 Merge "Small doc cleanup round." 2012-07-02 17:10:59 +00:00
annegentle 2a97d614b4 Small doc cleanup round.
- Changes theme to default instead of nature.
 - Explains in terms of Compute API instead of Rackspace
 - Remove outdated reference to nova-manage command
 - Remove unnecessary whitespace

Change-Id: I43d16cd053af0b4be48450fd638f9d17f9e5c4e7
2012-06-26 09:29:38 -05:00
Clark Boylan bb117a2d45 Update Contributing blurb in the docs.
Contributing blurb previously mentioned using Github pull requests.
Contributions should go to Gerrit instead.

Change-Id: Id7b7f968fa5a3785c19704b4c1c2408f48b335ca
2012-06-22 10:16:49 -07:00
Clark Boylan ebceca9414 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: I868df12e3c15cc30043e782ce0a609b9574295cd
2012-06-11 14:18:48 -07:00