Skip to content

docs: fix stale CONTRIBUTING.md and add missing Publishing section#134

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-contributing-accuracy-6d9f51ce2a79b3dc
Draft

docs: fix stale CONTRIBUTING.md and add missing Publishing section#134
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-contributing-accuracy-6d9f51ce2a79b3dc

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Summary

  • CONTRIBUTING.md — Testing section was stale: The section claimed "there is no automated test harness for skills," but the repo ships a full three-tier test suite (tests/). Replaced with an accurate description, a quick-start command block, and a tier summary table that matches tests/README.md.
  • CONTRIBUTING.md — workflow count was wrong: "seven dogfooded workflows" → "six", with each workflow named explicitly and the gh-aw-managed ones distinguished from standard GitHub Actions YAML.
  • README.md — missing Publishing section: CONTRIBUTING.md linked to README.md#publishing but the section did not exist. Added a five-step publishing checklist covering version bump, tag, GitHub release, marketplace auto-update, and plugin registry submission.

What was checked

  • Verified the workflow count by globbing .github/workflows/*.yml — six files found (agentics-maintenance, ci-tests, copilot-setup-steps, daily-repo-status.lock, update-docs.lock, weekly-research.lock).
  • Cross-referenced the Testing section against tests/README.md to ensure tier descriptions and timing estimates are consistent.
  • Confirmed README.md had no ## Publishing heading before this change.

Test plan

  • Check that README.md renders the new Publishing section correctly on GitHub
  • Check that CONTRIBUTING.md renders the test-tier table correctly
  • Verify that the README.md#publishing anchor link in CONTRIBUTING.md resolves now

🤖 Generated with [Claude Code]((claude.ai/redacted)

Generated by Update Docs ·

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/update-docs.md@96b9d4c39aa22359c0b38265927eadb31dcf4e2a

- Replace "no automated test harness" claim with accurate description
  of the three-tier test suite and a quick-start command table
- Correct workflow count from "seven" to "six" and name each workflow
  explicitly to distinguish gh-aw-managed from standard YAML
- Add README.md#publishing section (maintainer steps for bumping version,
  tagging, release, and updating plugin registries) — previously linked
  from CONTRIBUTING.md but absent

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation labels May 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants