Closes #951 (closed)
Getting there. This draft produces the rst syntax that looks like the existing code.
(top is produced by the directive reading the code, bottom is the written docs text; section is duplicated as I hadn't time to complete that today).
The decorator added in this merge request populates a list of parameters. This list is used by the Sphinx directive to produce the documentation. This part is already unit-tested, 100% covered. The rest of the work before this is ready for review includes:
-
add a decorator to mark the parameters -
use properties to define parameters -
generate the three sections with variables for jobs, platforms, and projects, automatically -
use the same list of parameters and docs to populate the comments in the YAML configuration where these parameters appear -
add unit tests to the parts changed, or new code -
make sure RTD rendered output matches the locally generated site - https://autosubmit--340.org.readthedocs.build/en/340/userguide/variables.html