Which Documentation Sections Should a Model Draft? A Free‑Tier Risk‑Split Workflow

说明与用途

该工作流确定哪些文档章节可以由 AI 模型安全生成，并通过 YAML 所有权文件和验证脚本强制执行边界，降低审查工作量。

问题

Determining which documentation sections can be safely drafted by an AI model to reduce review effort while maintaining accountability and verifiability.

结果

The workflow reduces review time by limiting AI drafting to fact‑extractable sections, enforces ownership boundaries with a YAML file and a verifier script, and operates entirely on free infrastructure.

工作流

• Update ownership.yaml with human owners for non‑draftable sections
• Generate API reference and setup stubs from source to provide a skeleton
• Draft allowed sections with a free AI server, marking output with <!--model-drafted-->
• Run the verifier script to flag any model output in human‑owned sections and open a review listing blocked sections first

证据

The table below is the core artifact of this workflow. Each row names a documentation section, marks whether a model may draft it, and states who owns the final text.

来源

The companion script reads the ownership file and fails whenever a human‑owned section contains model output.

来源