Jump to: navigation, search

Difference between revisions of "Blueprint-evolution-of-autogenerate-config-docs"

(Overview)
(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

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]

Related bug reports