Difference between revisions of "Blueprint-evolution-of-autogenerate-config-docs"
Jaegerandi (talk | contribs) (→Overview) |
Jaegerandi (talk | contribs) (→Current limitations) |
||
Line 10: | Line 10: | ||
== Blueprint == | == Blueprint == | ||
− | === Current limitations === | + | === Current limitations and problems === |
+ | |||
+ | * The sections are not shown at all | ||
+ | * We need to be able to show the same option in different tables for shared options | ||
+ | * Options with the same name - but specified in different tables - will show up as duplicated entries in a table. | ||
=== Using generator.py from oslo-incubator === | === Using generator.py from oslo-incubator === |
Revision as of 08:49, 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 and problems
- The sections are not shown at all
- We need to be able to show the same option in different tables for shared options
- Options with the same name - but specified in different tables - will show up as duplicated entries in a table.
Using generator.py from oslo-incubator
New format for generated tables
The tables should additionally contain the section, for example [DEFAULT]