Skip to content

docs: add catalog schema reference - #98

Open
DevOpsAIguru123 wants to merge 4 commits into
mainfrom
agentic-devops-daily-20260812-schema-docs
Open

docs: add catalog schema reference#98
DevOpsAIguru123 wants to merge 4 commits into
mainfrom
agentic-devops-daily-20260812-schema-docs

Conversation

@DevOpsAIguru123

@DevOpsAIguru123 DevOpsAIguru123 commented Aug 12, 2026

Copy link
Copy Markdown
Owner

Summary

  • Add docs/catalog-schema.md as the validator-backed catalog schema reference.
  • Link it from README, CONTRIBUTING, scoring, and safety docs.
  • Record the documentation addition in CHANGELOG.
  • Add regression tests that keep the schema reference aligned with validator allowlists for required fields, categories, artifact types, maturity values, and evaluation labels.
  • Maintainer refresh on 2026-08-13: extend the schema-reference regression tests to cover all validator enum constants, including action levels, human approval values, and evidence tracing values.
  • Maintainer refresh on 2026-08-13: clarify official-vs-community category provenance rules in the schema reference and add a regression test so contributor guidance does not disappear.

Validation

  • python3 scripts/sync_readme_counts.py
  • python3 scripts/sync_catalog_json.py
  • python3 scripts/validate_repos_yaml.py
  • /Users/tuximac/projects/awesome-agentic-devops/.venv/bin/python -m pytest -q
  • git diff --check

Results on 2026-08-13: README counts in sync, catalog JSON in sync, catalog validation passed for 80 entries, and 158 tests passed.

Risk

Docs and tests only. No catalog entries, credentials, infrastructure, workflow files, or generated counts changed.

Maintainer refresh on 2026-08-12 and 2026-08-13: updated existing daily PR instead of creating a duplicate.

@sonarqubecloud

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant