Skip to content

docs: center READMEs on maintainer-led GitHub governance - #489

Merged
johnlanni merged 1 commit into
mainfrom
codex/readme-github-governance
Nov 14, 2026
Merged

johnlanni merged 1 commit into
mainfrom
codex/readme-github-governance

Conversation

@johnlanni

Copy link
Copy Markdown
Collaborator

The English and Chinese READMEs currently lead with the self-hosted workspace, leaving GitHub collaboration and maintainer control of agent-assisted contributions in the background. Reframe both around open-source project governance: maintainers shape contributor agents' context before implementation through Proposal/Design Issues, structured requirements, constraints, and recorded decisions.

Describe the existing prompt-injection defenses and their limits, including untrusted-content boundaries and optional Runner authorization/sandboxing. Add a sourced Higress example that distinguishes its contribution policy from issue-spec defaults. Update GitHub onboarding to the current generated skills, remove retired review/verify/archive steps, and move self-hosting to a short final section.

Validation:

  • make verify-docs
  • go test ./internal/commands ./internal/commentrunner ./internal/templates -run '^(TestRead|TestSearch|TestAuthorizeCandidate|TestCoordinatorPrompt)' -count=1
  • Local Markdown links and heading anchors resolve; bilingual shell examples match; git diff --check passes.

Based on latest main at ab3e3944b052cc353ab4983c4a8a09e5e09fc2dc. Changes are limited to README.md and README.zh-CN.md.

Signed-off-by: johnlanni <zty98751@alibaba-inc.com>
@johnlanni
johnlanni merged commit fe7836a into main Nov 14, 2026
6 checks passed
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