Sign in

Search issue titles and bodies, change requests and comments. Private repositories you cannot read are not included.

vole
Clone

Read only, no credentials:

https://rodent.software/git/vole.git

Write over SSH with a registered key:

git clone ssh://git@0.0.0.0:2222/vole.git

A free and open-source forge that lives in your Git repo.

#177

Document where each role may push a change branch

merged · by keenan 6d ago · merged into main at f422c24f by keenan 6d ago

keenan opened this 6d ago

Why

Opening the recent changes, the workflow assumed a contribute account and put the branches under refs/heads/contrib/keenan/. This account is an admin. The guides described the contributor namespace as if it were the way to open a change, rather than one role’s namespace, so nothing told a maintainer or admin that an ordinary branch was the right place.

docs/accounts-and-access.md also said the CLI needed maintain for issues, comments and changes. Pre-receive applies the same per-path rules as the browser, so a contribute account can use those commands from its own branch.

What changed

  • CONTRIBUTING.md: say where a feature branch goes by role before the Git loop, and scope the contributor bullets to contribute accounts and refs/heads/contrib/ branches.
  • docs/change-requests.md: replace the contributor-only opening section with the branch rule for contribute and for maintain/admin, then keep the maintainer CLI example.
  • docs/accounts-and-access.md: correct the CLI capability paragraph.
  • docs/getting-started.md and docs/cli.md: say a contribute account’s branches live under the namespace, not “contributor branches” generally.

Verification

  • python3 scripts/check-links.py
  • ./vole workflow check

Discussion (0)

No discussion yet.