The man page for heat-keystone-setup-domain was not being generated
because it was not included in the sphinx conf.py.
Change-Id: Ic1c2025fc7f61e3c37906b42bd84e1df893920fc
Don't create empty properties fields in the resources samples.
This patch will help resolve niceness gates failures when generating the
docbook HOT reference.
Change-Id: I3c74fa583ac55dc0a23520ec07f5d07e3d1b6fab
Closes-Bug: #1360558
This directory was renamed in 4e8231, which made importing docker
(that is docker-py) difficult if not impossible in Python 2.x. So
rename it to something other than 'docker' to avoid that problem.
(setup.cfg has been modified with the new path)
Change-Id: I3cbb7c5d4b53f70e1dc6102881f8e05852341a9a
Related-bug: #1296758
Edits for consistency:
* Fix spelling and capitalization
* Add missing "."
* Use same layout for "Returns"
Change-Id: Ieb2effc1f45fb261f45775be9664ea93b04c8e98
Create the literal_block nodes with a 'language' attribute to add syntax
highlighting in the generated documentation.
This change is not visible in the HTML output, but is used when the
generated XML is imported in the openstack-manuals hot-reference book
(WIP).
The 'hot' language is not currently supported in sphinx or in the
manuals, but it doesn't hurt to have it and it could be implemented
later.
Change-Id: Ie5d4ab31665da812ccd7ec1232d3858786170477
Implements: blueprint heat-templates
Closes-Bug: #1360559
This change creates a pbr setup.cfg and specifies a data_files
entry to install the contrib plugin source into the /usr/lib/heat
plugin directory.
This change also temporarily disables docs building for contrib
resoures until the transition to stevedore is fully complete.
Change-Id: I1c91aee20f72dc2a5a049e67de1d6d7cbabda241
Include warning about updates not being supported for a propety
based on its `immutable` value being True.
Change-Id: I10fe495a2a35429b3d6e254c23ae91732e2e4dd8
Implements: blueprint implement-aws-updates-not-supported
The link referenced in templates/cfn/WordPress_Single_Instance
is dead. Looks like the directory was restructured. Updated using
a like for the F18 version of the template.
Change-Id: I46705cd31e2be6f3f131c64944665eabe6347dc9
Corrects some examples and remove trailing whitespace in
the Heat Resource Plug-in Development Guide
page (pluginguide.html)
Closes-Bug: 1350503
Change-Id: I34b142e950b9a4588b415d44274732d835cfd8f4
In order to make the generated documentation for resource plug-ins more
readable, parse the class comments as RST and append to the section.
Change-Id: Icb37344c64c21bcac536e8f2916b102eb9754851
rst2script.sed was referenced in the Fedora getting started
documentation, but the recommended way to use Heat/Openstack
on Fedora is now to use RDO/packstack.
Also removes the reference to rst2script.sed in the
getting_started/on_fedora documentation.
Also removes obsolete integration.sh script.
Partial-Bug: 1338066
Change-Id: I7f2b0d84ccef324ccb8e32ca4c6d90f9a3f2dda3
The next revision of HOT, dated 2014-10-16 to coincide with the Juno
release date, will support the list_join function and remove support for
the CFN-style functions. There may also be other changes throughout the
Juno development cycle.
Change-Id: I20d9586201806ac34e303689660ff565cb9f2b5c
Under the "Template input parameters" section, there was a typo in the
following sentence:
"For example, the following definition for the instance_type parameter
would select the ‘m1.small’ flavor unless specified otherwise be the
user."
Closes-Bug: 1339269
Change-Id: I59a170407669c74d23f36b232b3d492e52ce5eac
We have an increasing number of attributes which are a list of strings.
In HOT there is no way to join a list into a string as with the CFN
function Fn::Join.
This change implements HOT intrinsic function list_join using an
identical implementation as Fn::Join.
Tripleo will benefit from this function since the lack of a join
function in HOT is one of the barriers to transitioning to the
HOT template format.
Change-Id: I29e0b744271213429fff6922397b925eb9ccc204
The current order appears to be arbitrary. There is no other obvious
natural order so this change reorders alphabetically by the name
of the function.
Change-Id: Id1b0f02b8fb77f4e55827d962e3463d05245e564
The current structure must be baffling for new template authors.
First is a section on Environments, which is actually an advanced
topic. Then is a section on cfn compatible functions which users
should be spurning in favour of HOT intrinisic functions.
The actual docs on how to write a HOT template and the HOT spec
is buried at the end.
This change remedies this state of affairs by moving the
Heat Orchestration Template (HOT) Guide to the start, followed by
the HOT spec.
The Environments section is now after the resource types, and the
Functions section has been renamed CloudFormation Compatible
Functions.
How we document CloudFormation coverage probably needs to be
rethought, but that is beyond the scope of this change.
Change-Id: I2ef2568309427b37555bae3d6b24a1464a7379b1
Instructions on creating images that can be used for SoftwareConfig and
SoftwareDeployment are added.
Change-Id: If4bc6197ca38d73378ada6a6b32e47a658d88fc5
Updated contrib documentation with reference to the nova flavour README file.
Fixed the reference to the Docker documentation.
Change-Id: I23e352b8ec44424611066c0f64051ad3586b8c91
This patch makes sure that the <emphasis> tags used in the resources
generator are embeded in a <paragraph>.
This change makes it easier to convert from docutils XML to docbook by
providing a valid XML tree.
Change-Id: Icd48d8cc6d868f484de895a07bd696e951884109
Add a boolean parameter type to allow passing in boolean values via
parameters.
blueprint boolean-parameter-type
Change-Id: I693d0aa5bdc54bb57b8363633f1b41c59ccae7d3
This patch fixes all the missed and newly introduced violations of the H306
style checking rule and enables it in tox.
Change-Id: I5566e66421d5397c0103958f02ea38e6e3c68892
Implements: blueprint reduce-flake8-ignored-rules (partial)
The link to the API reference was pointing to api-ref-orchestration,
which is incorrect. This changes it to api-ref-orchestration-v1.
Closes-Bug: #1320956
Change-Id: I3eb46af60dffc47e62ffbfc9f407f7f1a86a56a1
This is to just make it clear that there are other resources
besides Rackspace ones.
This is not really a bug as both the rackspace and docker
headings are the same level, but when going to the page it
is easy to see why the bug was made.
Change-Id: I76a8bcf63b7c976c4fcf0baecfd58e5fcbb65d96
Fixes-bug: #1311565
All python files in plugins were automatically loaded which would
add the dependencies of the tests to the plugins.
Let skip the files in the .tests. namespace
Closes-Bug: #1292655
Change-Id: I25eac87559b5852e9645fbb84c8b4d07b4c1ff42
At now attributes have their own Schema class with support_status
option. This information should be displayed in documentation.
Current change makes possible to use new schema for building
documentation.
Change-Id: I40af79b57defb99c7b131583b5fedfd3a67968d1
Closes-Bug: #1306383