How I Validate an Evidence-Backed YAML Catalog Contribution Before Opening a Pull Request

说明与用途

验证 YAML 目录条目的分步流程：从阅读仓库规则到创建不可变提交链接，确保准确性、无重复和符合政策。

问题

Ensuring that YAML catalog contributions are factually accurate, sourced, non-duplicative, and compliant with repository rules before opening a pull request.

结果

The workflow ensures that each YAML contribution is fully sourced, non-duplicative, structurally valid, and compliant with repository policies, resulting in faster reviews and higher data quality.

工作流

• Read repository contract (CONTRIBUTING.md, PR template, existing files)
• Establish source of truth (vendor website, canonical URL)
• Search for duplicates (repo, PRs, issues)
• Preserve exact source fidelity (field-by-field comparison)
• Validate structure with repository verifier and taxonomy
• Enforce one-file scope (diff inspection)
• Check DCO sign-off
• Run overclaim check (adversarial review)
• Create immutable review evidence (commit SHA links)

证据

The method kept a small change reviewable and stopped unsupported claims from hiding inside structurally valid YAML.

来源

I used the verifier and taxonomy pinned by the repository. Its documented preflight validates the changed dependency closure against the merge base.

来源