helm-charts icon indicating copy to clipboard operation
helm-charts copied to clipboard

Evaulate the markdown generator tooling for better maintenance of README.md files

Open edwbuck opened this issue 1 year ago • 1 comments

After the README.md is fully migrated off of the helm_docs generator, and at least one section of the massive output table is restructured to follow the usage / configuration of a limited-in-scope topic, the new markdown generator suggested by Vivek needs to be evaluated to see if it can automatically generate / maintain the README.md while maintaining the "values within topics" approach.

The adoption or non-adoption of the new generator will depend on the ability to generate similar, output, structured by specific configuration topics. This means this issue cannot be started until there is at least one topic of values broken out of the large "all values" table, and preferably would not be started until there are two topics broken out of the "all values" table.

The goal is not to match the manually maintained Markdown output 100%; but, to evaluate how much of the output is maintained in the desired "topic oriented" structuring, as well as to determine the correct tooling to provide easy to maintain README.md files, and easy to follow / understand instructions to the reviewers to adjust their review process in accordance with the new tooling.

The work done to support this issue may be accepted or rejected based on the suitability of the solution and the quality of the output.

edwbuck avatar Jul 26 '23 03:07 edwbuck