chore: add governance, CI, and repo tooling for the org .github repo - #2
Merged
Conversation
Round out the org .github repo with the remaining supported files: - GOVERNANCE.md: inherited org-wide governance (roles, lazy-consensus, maintainership). - .github/workflow-templates/: org starter workflow (python-ci: uv + ruff + pytest). - .github/FUNDING.yml: commented reference template (not inherited). - .github/PULL_REQUEST_TEMPLATE/: named feature/bugfix/docs PR templates. - AGENTS.md and .github/copilot-instructions.md: AI-agent guidance. - Dev-hygiene: .editorconfig, .gitattributes, .gitignore, .markdownlint.json, .pre-commit-config.yaml, CHANGELOG.md. - CI: ci.yml (markdownlint + link check + YAML syntax), labeler.yml, labels.yml, and a markdownlint composite action. - Label config: .github/labeler.yml and .github/labels.yml. Also convert relative links in CONTRIBUTING.md and SUPPORT.md to absolute https://github.com/perishdev/... URLs so they resolve when inherited, and update CLAUDE.md to document the new layout.
- markdownlint: add language to CLAUDE.md fenced block (MD040), make the CoC enforcement email a mailto autolink (MD034), and disable the version-dependent MD060 table-alignment rule. - link check: drop invalid --exclude-mail flag (lychee excludes mail by default). - yaml syntax: install PyYAML before the parse step (not preinstalled on runners).
Org Discussions (github.com/orgs/perishdev/discussions) and other perishdev self-references 404 during setup. Exclude any URL containing 'perishdev' instead of only the anchored github.com/perishdev prefix.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Rounds out the
@perishdevorg.githubrepository with the remaining supported files and some repo hygiene.Added
GOVERNANCE.md— inherited org-wide (roles, lazy-consensus decision-making, becoming a maintainer)..github/workflow-templates/— org starter workflowpython-ci(uv + ruff + pytest). Not inherited; shown under Actions → New workflow..github/FUNDING.yml— commented reference template (repo-specific, not inherited)..github/PULL_REQUEST_TEMPLATE/— namedfeature/bugfix/docstemplates (opt-in via?template=); the root default template is unchanged.AGENTS.md+.github/copilot-instructions.md— AI-agent guidance; concise, defer toCLAUDE.md..editorconfig,.gitattributes,.gitignore,.markdownlint.json,.pre-commit-config.yaml,CHANGELOG.md.ci.yml(markdownlint + link check + YAML syntax),labeler.yml,labels.yml, and a reusable.github/actions/markdownlintcomposite action..github/labeler.yml(path-based PR labels) +.github/labels.yml(label sync source of truth).Changed
CONTRIBUTING.mdandSUPPORT.mdto absolutehttps://github.com/perishdev/...URLs so they resolve correctly when inherited by other repos.CLAUDE.mdto document the new layout.Notes
github.com/perishdevself-links to avoid false failures while org repos may be private/not-yet-created.skip-delete: true(non-destructive).@v4/@v5).