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/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 · 9h 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/runner.md +5−5

@@ -478,9 +478,9 @@ page can show a step's output without downloading the image build and other step
478 478 Step timing is recorded beside the range.
479 479
480 480 ```text
481 /r/<repo>/runs/<id>/log # latest attempt
482 /r/<repo>/runs/<id>/log?attempt=N # a particular retry
483 /r/<repo>/runs/<id>/log?step=N # one step inside that attempt
481 /<repo>/runs/<id>/log # latest attempt
482 /<repo>/runs/<id>/log?attempt=N # a particular retry
483 /<repo>/runs/<id>/log?step=N # one step inside that attempt
484 484 ```
485 485
486 486 If a runner is killed, its attempt has no log. A record written before step
@@ -492,8 +492,8 @@ All runners share one pool. An idle runner waits for work instead of asking
492 492 repeatedly, and Vole gives the next job to the repository with the least work in
493 493 progress. Set `max_jobs_per_repo` when you need a hard limit per repository.
494 494
495 The instance-admin **Admin** page at `/admin?tab=runners` shows who is connected,
496 what each runner is building, and how much work is queued. The old `/runners` URL
495 The instance-admin **Admin** page at `/-/admin?tab=runners` shows who is connected,
496 what each runner is building, and how much work is queued. The old `/-/runners` URL
497 497 redirects there.
498 498
499 499 How the queue behaves: