Looks like a larger change than it is, mostly just refactoring generate_config_rst.py so that it handles if and oneOf wherever they appear. Behaviour changes are that it now also supports $ref, and to introduce some nesting to distinguish deeper fields. Comparing the 2 side-by-side, I might remove this as I don't think it actually aids readability.
Updated:
Dropped use of nested definitions, as I couldn't get them formatted nicely. Instead we use the old behaviour of separate section headers for each property, so the only changes are that we include paths in the property names (which I think makes it easier to scan the tree), and add some more space in the display of leaf elements (and uniformity of describing type, default values etc everywhere).
Looks like a larger change than it is, mostly just refactoring
generate_config_rst.py
so that it handlesif
andoneOf
wherever they appear. Behaviour changes are that it now also supports$ref
, and to introduce some nesting to distinguish deeper fields. Comparing the 2 side-by-side, I might remove this as I don't think it actually aids readability.Updated:
Dropped use of nested definitions, as I couldn't get them formatted nicely. Instead we use the old behaviour of separate section headers for each property, so the only changes are that we include paths in the property names (which I think makes it easier to scan the tree), and add some more space in the display of leaf elements (and uniformity of describing type, default values etc everywhere).
Before:
After: