vole

Clone

Read only, no credentials:

https://rodent.software/vole.git

Write over SSH with a registered key:

git clone ssh://git@rodent.software:2222/vole.git

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

Document the root-level URL layout

b7396a1155147a13c5595216f204a545e9f74202 · Keenan Nemetz · 10h ago · parent ed03b3d1

Document the root-level URL layout

The guides now say /<name> for a repository and /-/ for the forge's own pages,
including the clone examples, theme asset paths, profile and registration
URLs, robots.txt, and the deployment package URLs. docs/architecture.md gains
a short URL layout section: why the two spaces cannot collide, the four root
names the forge keeps, and why the transport carries .git.

docs/go-modules.md follows the layout: the module path is the repository page,
the clone URL is the same name with .git, discovery is answered before the
router, and a published module path is durable because renaming the repository
breaks it.

docs/releases.md +4−4

@@ -35,12 +35,12 @@ the web refuses the edit. Lightweight tags are never editable.
	35	35
	36	36	## Download source archives
	37	37
	38		The `/r/<repo>/releases` page lists every tag. A release page shows the notes, the
		38	The `/<repo>/releases` page lists every tag. A release page shows the notes, the
	39	39	commits since the previous release, and two generated downloads:
	40	40
	41	41	```sh
	42		curl -O http://host/r/demo/releases/v1.0.0/archive.tar
	43		curl -OJ http://host/r/demo/releases/v1.0.0/archive.tar.gz
		42	curl -O http://host/demo/releases/v1.0.0/archive.tar
		43	curl -OJ http://host/demo/releases/v1.0.0/archive.tar.gz
	44	44	```
	45	45
	46	46	Vole builds the archives from the tagged tree when someone requests them, so they
@@ -57,7 +57,7 @@ them:
	57	57
	58	58	```sh
	59	59	vole release attach v1.0.0 dist/vole-linux-amd64 dist/vole-darwin-arm64
	60		curl -O http://host/r/demo/releases/v1.0.0/artifacts/vole-linux-amd64
		60	curl -O http://host/demo/releases/v1.0.0/artifacts/vole-linux-amd64
	61	61	sha256sum vole-linux-amd64
	62	62	```
	63	63