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.

Unify account terminology and clarify ACL commands

2e024cc96a391c0959ad2914caeed78b600fcfc1 · Keenan Nemetz · 14d ago · parent ab326d3a

Unify account terminology and clarify ACL commands

Use account consistently in the CLI, help, docs, and remote admin messages. Rename the CLI account command from user to account while retaining the old user spelling as an alias.

Replace positional ACL mutations with explicit verbs such as set-role, protect add, runners remove, and checks enable. Update local and remote admin parsing, hints, docs, and tests.

Tidy repository filter alignment and remove duplicated issue/change counts from page subtitles.

docs/README.md +7−5

@@ -49,21 +49,23 @@ organized.
	49	49	Use one word for each concept, in the interface and the guides:
	50	50
	51	51	- account: the identity that owns keys, passkeys, sessions, and roles. The CLI
	52		spells its commands `vole admin user ...` and the database file is
	53		`data/users.db`; in prose it is still an account.
		52	spells its commands `vole admin account ...`; `vole admin user ...` remains as
		53	an alias. The database file is `data/users.db`; in prose it is still an account.
	54	54	- repository: the Git repository and what belongs to it. The CLI uses `repo`
	55	55	and URLs use `/r/<name>`; do not call it a project.
	56	56	- change request: a proposed branch reviewed before landing. The CLI uses
	57	57	`change` and the route is `/requests`.
	58	58	- enrollment link: the one-time link that lets someone register a passkey and
	59		sign in. The CLI command is `user invite`, and some code calls it an invite.
		59	sign in. The CLI command is `vole admin account invite`, and some code calls it
		60	an invite.
	60	61	- instance admin: the instance-wide `admin` role. Say "instance admin", not
	61	62	"administrator", when that is what you mean.
	62	63	- sign in / sign out: the browser action. `login` and `logout` remain in
	63	64	routes, setting names, and code.
	64	65
	65		File names, command names, and URL paths keep their historical spellings; the
	66		words above are what the interface and documentation should say.
		66	The `data/users.db` filename, the `/requests` URL, and the `user` command aliases
		67	keep their historical spellings; the words above are what the interface and
		68	documentation should say.
	67	69
	68	70	## A few conventions
	69	71