Extract Configuration Keys From Argparse and Env Bindings; Humans Own Units, Secrets, and Restarts

说明与用途

该工作流从 argparse 提取配置键，然后由人工审核签署默认值、单位、重启和机密信息，确保文档准确可靠。

问题

Generated configuration pages often copy parser defaults without signed ownership for units, restarts, and secrets, leading to inaccurate or incomplete documentation.

结果

The workflow produces accurate, publication‑grade configuration documentation while keeping human‑owned claims explicit and verifiable.

工作流

• 1. Run the extractor script on the target module to harvest flag names, env names, types, help strings, and default expressions as unevaluated strings.
• 2. Store the extracted data in a facts file (JSON/YAML).
• 3. Review the facts file and create a decision table next to it.
• 4. Draft documentation sections (grouping, headings, example YAML/dotenv) from the facts file using a docs editor.
• 5. For each claim that requires human ownership (default values, units, restart requirements, secret classification, deprecation), add a reviewer signature and evidence (release tag, runbook, threat note).
• 6. Reject any unsigned claim from the published reference.
• 7. Publish the finalized documentation once all required signatures are present.

证据

Generated configuration pages fail when they copy parser defaults without a signed owner for units, restarts, and secrets.

来源

The extractor only makes violations visible.

来源