Difference between revisions of "Blueprint-evolution-of-autogenerate-config-docs"
Jaegerandi (talk | contribs) (→Overview) |
Jaegerandi (talk | contribs) (→Overview) |
||
Line 7: | Line 7: | ||
The current autogenerate tools have a couple of limitations and we need to improve the tool to handle all current uses in the manuals. We should also evaluate switching to generator.py from oslo-incubator - and enhancing that tool. | The current autogenerate tools have a couple of limitations and we need to improve the tool to handle all current uses in the manuals. We should also evaluate switching to generator.py from oslo-incubator - and enhancing that tool. | ||
+ | |||
+ | == Blueprint == | ||
+ | |||
+ | === Current limitations === | ||
+ | |||
+ | === Using generator.py from oslo-incubator === | ||
+ | |||
+ | === New format for generated tables === | ||
+ | |||
+ | The tables should additionally contain the section, for example <code>[DEFAULT]</code> | ||
== Related bug reports == | == Related bug reports == | ||
* [https://bugs.launchpad.net/openstack-manuals/+bug/1226464 Duplicates in generated tables] | * [https://bugs.launchpad.net/openstack-manuals/+bug/1226464 Duplicates in generated tables] |
Revision as of 08:42, 7 October 2013
- Launchpad Entry: Evolve autogenerate tools
- Created: Andreas Jaeger
- Contributors:
- Planned implementation release: Icehouse
Contents
Overview
The current autogenerate tools have a couple of limitations and we need to improve the tool to handle all current uses in the manuals. We should also evaluate switching to generator.py from oslo-incubator - and enhancing that tool.
Blueprint
Current limitations
Using generator.py from oslo-incubator
New format for generated tables
The tables should additionally contain the section, for example [DEFAULT]