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.

Name branches after the account, and labels after the display

474a812d199a109ba894124cd6f26be12c73285d · Keenan Nemetz · 15d ago · parent ade6107e 

Name branches after the account, and labels after the display

A contributor's folder was `refs/heads/contrib/<account-id>/`, which told a
reader nothing without decoding a ULID. It is now the account name,

    refs/heads/contrib/<name>/<branch>

and the name is therefore fixed at creation: renaming an account would strand
every ref under its old folder, so `vole admin user rename` is gone and the
users row itself — kept after retirement — is what stops a name being reissued.

What people see is now a separate, mutable display name, validated by the same
rules wherever it is set (CLI, remote admin, registration, `/account`) and shown
on pages, approvals, listings and refusals. Nothing is authorized by it and
nothing on disk is keyed by it: metadata authors stay account names because the
push boundary resolves them for ownership, and approvals stay account ids.

`user_names`, `Snapshot.Reserved` and `Account.Former` are dropped: with a fixed
name there are no former names to remember, and the UNIQUE column already does
the reserving. Opening an older roster adds the `display` column and drops the
alias table in place; contributor refs written under the old id namespace are
left where they are, readable, and landable by a maintainer.

docs/getting-started.md +4−2

@@ -61,8 +61,10 @@ vole admin repo create demo --owner you
61 61
62 62 Creating an account requires its first SSH key: the account and key are written
63 63 together, so a name is never claimed by an account that cannot sign in. Use
64 `vole admin user add-key` afterwards to attach more keys. The owner of a new
65 repository is its first admin.
64 `vole admin user add-key` afterwards to attach more keys. The account name is
65 permanent — contributor branches live under `refs/heads/contrib/<name>/` — so pass
66 `--display "Your Name"` if you want a friendlier label on pages. The owner of a
67 new repository is its first admin.
66 68
67 69 New repositories are private. To make the web page and anonymous clone URL
68 70 readable, publish it: