Skip to content

docs: document required GitHub repository settings for scaffolded plugins - #58

Merged
TomKaltofen merged 1 commit into
mainfrom
docs/repository-settings
May 25, 2026
Merged

docs: document required GitHub repository settings for scaffolded plugins#58
TomKaltofen merged 1 commit into
mainfrom
docs/repository-settings

Conversation

@TKaltofen

Copy link
Copy Markdown
Collaborator

Summary

  • Adds docs/github-repository-settings.md covering the GitHub-side configuration the inherited workflows depend on: required secrets, branch protection on main (with the release.yaml push interaction with "Require a pull request before merging" called out), the matrix-expanded required status check names (test (3.10) through test (3.13)), and dependabot assignee setup.
  • Adds a brief PyPI Trusted Publisher pointer as a modern alternative to PYPI_API_TOKEN.
  • Links the new doc from README.md "Where to next" and docs/getting-started.md "After Creating Your Repository".

Companion to the existing docs/github-workflows.md, which already documents how to mint each token; this doc covers the repository-side settings that go alongside it.

Closes #48

Test plan

  • tox passes locally (docs-only change, but verified)
  • Markdown links resolve in GitHub preview
  • Doc reads cleanly for a plugin author who has just clicked "Use this template"

…gins

Adds docs/github-repository-settings.md covering repository-side
configuration that the inherited workflows expect: required secrets,
branch protection on main (including the release.yaml push interaction
with "Require a pull request before merging"), the matrix-expanded
required status check names, and dependabot assignee setup.

Links the new doc from README "Where to next" and docs/getting-started.md
"After Creating Your Repository".

Closes #48
@TomKaltofen
TomKaltofen merged commit eab9079 into main May 25, 2026
4 checks passed
@TomKaltofen
TomKaltofen deleted the docs/repository-settings branch May 25, 2026 14:08
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.

docs: document required GitHub repository settings for scaffolded plugins

2 participants