• Start research in the docs release playbook. Read all links and linked issues related to reference doc generation. (Make sure you understand the scope of the problem and what's required to fix it.)

• Create a new GitHub issue describing the requirements and scope of work required to refactor reference doc generation for a simple, reliable set of commands that produces output with improved, uniform formatting. (Make it easy for other stakeholders to understand the extent of the challenge and what's required to fix it.)

• Get stakeholder input, then implement a solution. (Get everyone on board, then fix the problem. The docs should be easy to generate, and the outputs should all match with better formatting.)

/sig docs
/priority important-soon
Assign to @aimeeu