docs: add organization profile and contribution guide#1
Open
kerberizer wants to merge 2 commits into
Open
Conversation
Classify production, staging, generated, unfinished, and historical repositories for users and contributors. Add inherited contribution guidance that routes changes to controlling sources and records release, signing, generated-file, and validation expectations without introducing unresolved organization-wide security or governance policy.
Member
Author
|
An important point about the review: I'm mostly looking for an approval on the general direction and only possibly -- if you can find the necessary time, which very understandably can be quite tight -- finding areas for improvement or necessary corrections. In other words, I absolutely don't want to burden you with tons of content to review. I have myself reviewed as carefully as possible the PR changes, but it's still just a single pair of eyes and a single, inevitably limited, human brain. :) |
1 task
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
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.
Motivation
The organization currently presents generated package repositories, production infrastructure, staging work, unfinished security and mirror projects, and historical Buildbot code without an organization-level map. Contributors can easily choose a generated repository instead of the controlling source, while users have little context for the current
experimentalrelease name.Changes
CONTRIBUTING.mdthat routes changes to the controlling repository.The profile labels keyring packaging and reusable mirror tooling as unfinished and
archzfs-cias historical rather than presenting them as deployed alternatives.Organization-wide impact
CONTRIBUTING.mdbecomes GitHub’s default contribution guide for organization repositories that do not provide a local override, including generated package repositories. GitHub displays this inherited file but does not copy it into repository clones. Repository-critical operational rules therefore remain in each controlling repository’s own instructions.No security, governance, support, issue-template, or PR-template defaults are added; those require separate policy decisions.
Validation
git diff --checkacross the complete branch diff.Documentation only. This does not change packages, workflows, releases, signing, repository settings, or generated sources.
Coordination
The current-architecture and agent guidance is under review in archzfs/archzfs#644. Wiki refresh commits
46235a0andfd5baeeare published. Temporary dependency notices remain on the Wiki Home and Development pages until this PR and archzfs/archzfs#644 merge.Wiki follow-up