486 Commits

Author SHA1 Message Date
Steve Baker
34e47b64d9 Move heat-cfn, heat-boto, heat-watch to new repo
The new home for these tools is
https://github.com/openstack-dev/heat-cfnclient

These tools are now aimed at heat developers only
and they will not be released or packaged.

Change-Id: I1ea62ef17e81ab53cacb5e4940f0c4e2516ed383
2013-08-13 12:26:43 +12:00
Thomas Spatzier
514e9b746c Initial input for HOT template guide and spec
This patch adds initial input for the HOT template guide and the HOT
specification.
Note that content so far is based on features implemented so far and
not forward-looking in any way. Whenever new features get implemented,
the guide and spec will be extended appropriately.

Contributes to blueprint hot-specification

Change-Id: I63d29ab0a1db6703b39f981161063d4fd9f97126
2013-08-09 11:07:34 +02:00
Steven Dake
ed0fb7e823 Rename Quantum to Neutron
quantumclient is gone upstream and has been replaced by neutronclient.

This patch retains the OS::Quantum::XX namespace

Fixes: bug #1197208

Change-Id: Id48f9598ea1884132d411ad533770ae49494102b
2013-08-06 22:08:27 -07:00
Steve Baker
c1be1264b9 Functions documentation cleanup.
- Switched to definition lists for parameters to be consistent
  with generated resource docs
- Make consistent the layout of literal blocks and returns
- Other minor grammatical and layout fixes

Change-Id: I62eb179ce2a20024d2195cc7eb88e2e79bd4ae68
2013-07-27 11:37:32 +12:00
Steve Baker
4af4c719a8 Auto-document all resource types.
There are separate pages for OpenStack, AWS and Rackspace resources.

Currently the following sources are used for resource type documentation:
- the docstring for the resource class
- properties_schema
- attributes_schema

Change-Id: I901d227e8bc2a7209f216b57653da77a4f500e47
2013-07-26 09:04:12 +12:00
Steve Baker
ad945070a2 Sphinx extension to generate resource documentation.
Implements a resourcepages directive which generates resource type
documentation for any type that matches the specified type prefix.

For example:
.. resourcepages:: OS::

Implements blueprint generate-resource-docs

Change-Id: I3b2c94a766686e17e2bdbe8be27657decd65bb3e
2013-07-26 08:59:16 +12:00
Angus Salkeld
08e04e6733 Add some docs for intrinsic functions.
And start the template guide.

DocImpact
Change-Id: I4dc32dfc20b464e09b78f192b6f4931ce812fd4b
2013-07-25 14:54:15 +10:00
Jeff Sloyer
6bfd774df8 add docs from the heat wiki
updated index.rst to mimic the layout of the keystone docs
updated the structure for troubleshooting
ported howto guides from the heat wiki
ported the troubleshooting page from the heat wiki
updated the nav for the man pages and getting started
added docs for a cfn template and hot template

Change-Id: I14c1b0b6aa6ea3529c4de994851f7a798a3061bf
2013-07-17 18:35:18 -04:00
Monty Taylor
c7f313551e Fix version and location of heat doc build
pbr injects version information as part of the build_sphinx command,
so having it here is overkill.

Change-Id: I1f89e068da3e47b94434cb71db87704f9665dea2
2013-07-16 14:29:30 -04:00
Angus Salkeld
3bac114e8f Suggest the use of tripelO images
Change-Id: I8dfb18fe3f52baea99ed34cc271241b8e24c8104
2013-07-08 13:03:45 +10:00
Angus Salkeld
95ac80a0d5 API support for Environments
Support "Environment" section in the create/update body.
We the roll up the parameters and the environment and send
that as json using the rpc "params" argument. So no changes
to the rpc layer are needed. The engine knows how to deal
with both formats in the Environments class.

blueprint envirnonments
Change-Id: I6d6085d5c052a5f9115ecd46891b00d2fad4d1db
2013-06-17 20:26:28 +10:00
Dirk Mueller
f4df0b186a Fix various Sphinx errors/warnings
Change-Id: If34202291b5605302baf47c210b07ffc4ffad094
2013-06-10 23:49:40 +02:00
Shengjie Min
65e0706874 update on_devstack doc
udpate the prebuilt-jeos-image from F16 to F17

Change-Id: Iae1456e4811c029494a8c2878c9bf0c3221bc43a
Fixes: bug #1180416
2013-05-21 11:09:21 +01:00
Steven Hardy
b7c5e698e2 docs : update local template references to heat-templates url
Update references to the to-be-removed in-tree templates, so
we use raw URLs to the heat-templates repo instead

Change-Id: I2121cedc2bffe1760d845dd2d87d97dd2265f1e9
2013-05-07 16:56:41 +01:00
Steven Hardy
459fb9472c heat docs : Update jeos building documentation
Replace references to heat-jeos with documentation describing the
use of the new heat-templates/tools/heat-jeos.sh example script

fixes bug #1171602

Change-Id: I88fd2a5667cccd79a77c4a663c782fb537279fac
2013-04-30 14:51:43 +01:00
Steve Baker
c0c1768e4a Consolidated api-paste.ini file
Load a single api-paste.ini file, specified by config
Delete unused paste.ini files
Update docs for new paste.ini and config arrangement

There will be a corresponding devstack change, and once this is in
I will email the packagers on the packaging implications

Change-Id: Ic10b1a486094d15bfd832f0f934e6268ec323085
2013-04-24 09:18:15 +12:00
Steven Hardy
092222de42 heat : Getting started updates for grizzly
Update GettingStarted to drop references to F16/essex and add the
password sed which is required when running grizzly installed via
tools/openstack on Fedora

Change-Id: I08d265e2e2388b54a6aa9f47c4930c32f71f3e93
2013-04-09 10:32:13 +01:00
Jenkins
4128aeed62 Merge "ReST API: Translate the documentation to WADL" 2013-04-08 09:43:34 +00:00
Steve Baker
fc90b85bf8 Replace deprecated commands with current equivalents
Change-Id: I871d7f0e5cd0a22a284a6e6733607feafbbb52a2
2013-04-05 11:35:28 +13:00
Steve Baker
19afa57bfd Fix sphinx warnings
Change-Id: I0e2e837d7114bde22a5a4b2ffb65aa06416c0a97
2013-04-05 11:30:59 +13:00
Zane Bitter
f8b684d9a8 ReST API: Translate the documentation to WADL
Change-Id: Ib1847ee2266d188f198fdf8fb7feb53770d9c1a5
2013-04-04 19:25:24 +02:00
Angus Salkeld
2b420437fd Add Getting Started Guides the developer doc's
These have been copied from the wiki.

DocImpact
Signed-off-by: Angus Salkeld <asalkeld@redhat.com>

Change-Id: I4c93bc5a1811e674cef3c7868e7cf9a457c12dea
2013-04-04 15:28:04 +11:00
Jenkins
e08ff182a4 Merge "Add heat-keystone-setup man page" 2013-03-17 21:04:42 +00:00
Jenkins
9b6b6dfe56 Merge "heat docs : Add 2013 to the copyright string" 2013-03-15 21:43:43 +00:00
sdake
30fab61177 Add a manual page for heat-db-setup
Change-Id: I628d9e1295238b0bc405fc6ccb464889b85090e0
Fixes: Bug #1153691
2013-03-15 10:09:02 -07:00
Steven Dake
bc8f069928 Add heat-keystone-setup man page
Change-Id: I314ce01d35d65e3b50b72d2abaf51710b8461da7
Fixes: Bug #1153693
2013-03-15 10:06:49 -07:00
sdake
2daef27b6a Sort the manual page list in conf.py
Change-Id: I81c193c23a3b78cb98d54157a486bf15dc3ab979
Fixes: Bug #1153691
2013-03-14 11:30:34 -07:00
Jenkins
20cf011566 Merge "heat docs : Add heat-watch manpage" 2013-03-13 19:15:37 +00:00
Steven Hardy
22c9c4e76f heat docs : Add manpage for heat-boto
Fixes bug 1153688

Change-Id: Ie48c7158d253951e5885e8b701cd1c4c9a5fa37e
2013-03-13 14:12:29 +00:00
Steven Hardy
76a0fb43dc heat docs : Add 2013 to the copyright string
Change-Id: I0c86ccfd7232396d1fc6883b37adc2d5b877d19c
2013-03-13 11:39:13 +00:00
Steven Hardy
481c8104ed heat docs : Add heat-watch manpage
fixes bug 1153689

Change-Id: I7a4566cb850cf94761c1948fa7ad976e7d4f5446
2013-03-13 11:37:59 +00:00
Angus Salkeld
193f2b257c Remove todolist from docs index
This does not seem to be supported, so removing.

bug 1153681
Signed-off-by: Angus Salkeld <asalkeld@redhat.com>

Change-Id: I830980997438562d1ec241c33fcd8e67c32b21d9
2013-03-13 11:13:12 +11:00
Angus Salkeld
3c11589e37 Make the doc look a bit better and give a better overview.
(styles mostly copied from Ceilometer docs)

Change-Id: Ie3eab4f579e0c16a09634faffb90e96a872d5d84
2013-02-11 14:49:52 +11:00
Steven Hardy
a43fcaab7b heat docs : Fix version string issue
Fix issue with release/version strings in doc build config
which was causing doc builds to fail with an error.

Fixes bug 1115269

Change-Id: Ia02d52f502d808d758a541e84056d5ac94aff8b8
Signed-off-by: Steven Hardy <shardy@redhat.com>
2013-02-04 14:23:07 +00:00
Dirk Mueller
f09858e373 Merge from Oslo-incubator
Change-Id: I2ef3bb9acdfb5bcae574d812e06fd689d0a7c890
2013-01-28 18:18:57 +01:00
Steve Baker
c4777794e7 A new documention structure, ready for contributions
Here are some skeletons for the documentation which will need to be written.

doc/source
	A Sphinx based document which will be aimed at heat developers.
    	This also contains .rst files which generate the man files
doc/docbkx/api-ref
	Docbook and WADL for the REST API, with the intent of moving this
	to api-site to publish to api.openstack.org
doc/docbkx/heat-admin
	Docbook manual targeted at Heat admins, with the intent of moving this
        to openstack-manuals to publish to docs.openstack.org
doc/docbkx/heat-cli
	Docbook manual targeted at users of the Heat CLI, with the intent of
	moving this to openstack-manuals to publish to docs.openstack.org

Dude, wheres my man pages?
docs/man
	is deleted, now generated into doc/build/man

Packaging will need to be updated to generate the man pages

Change-Id: Idf2f37086b6f97df18ed57172de2f9e3d4c7706a
2012-12-19 10:22:35 +13:00