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.
Rename the request command to change
04e00cfc28cab9bfd338067a0edb4a6125164758 · Keenan Nemetz · 16d ago · parent f920a9f1
docs/change-requests.md +14−14
| @@ -26,10 +26,10 @@ Maintainers can still use the CLI: | |||
| 26 | 26 | ```sh | |
| 27 | 27 | # The author pushes a branch and opens a request. | |
| 28 | 28 | git push origin feature:refs/heads/feature | |
| 29 | vole request new --title "Retry on timeout" --base main --head feature -m "Rationale." | ||
| 29 | vole change new --title "Retry on timeout" --base main --head feature -m "Rationale." | ||
| 30 | 30 | ||
| 31 | 31 | # An approver reviews that commit and approves it. | |
| 32 | vole request approve <id> --as <your-name> | ||
| 32 | vole change approve <id> --as <your-name> | ||
| 33 | 33 | ||
| 34 | 34 | # The author lands it. Vole checks that the approval still matches the new tip. | |
| 35 | 35 | git push origin feature:refs/heads/main | |
| @@ -38,14 +38,14 @@ git push origin feature:refs/heads/main | |||
| 38 | 38 | Other commands: | |
| 39 | 39 | ||
| 40 | 40 | ```sh | |
| 41 | vole request list [--state open|closed] | ||
| 42 | vole request show <id> | ||
| 43 | vole request update <id> --head <rev> | ||
| 44 | vole request close <id> | ||
| 45 | vole request reopen <id> | ||
| 41 | vole change list [--state open|closed] | ||
| 42 | vole change show <id> | ||
| 43 | vole change update <id> --head <rev> | ||
| 44 | vole change close <id> | ||
| 45 | vole change reopen <id> | ||
| 46 | 46 | ``` | |
| 47 | 47 | ||
| 48 | `vole request show <id>` also tells you whether the branch still merges, when the | ||
| 48 | `vole change show <id>` also tells you whether the branch still merges, when the | ||
| 49 | 49 | needed commits are available locally. If they are not, it says so rather than | |
| 50 | 50 | guessing. | |
| 51 | 51 | ||
| @@ -78,10 +78,10 @@ example, if the base branch no longer exists. | |||
| 78 | 78 | ## Review comments | |
| 79 | 79 | ||
| 80 | 80 | ```sh | |
| 81 | vole request comment <id> -m "Does this hold for the empty repository case?" | ||
| 82 | vole request comment <id> -m "Good catch, amended." # prints the comment id | ||
| 83 | vole request edit-comment <id> <comment-id> -m "Rephrased." | ||
| 84 | vole request rm-comment <id> <comment-id> | ||
| 81 | vole change comment <id> -m "Does this hold for the empty repository case?" | ||
| 82 | vole change comment <id> -m "Good catch, amended." # prints the comment id | ||
| 83 | vole change edit-comment <id> <comment-id> -m "Rephrased." | ||
| 84 | vole change rm-comment <id> <comment-id> | ||
| 85 | 85 | ``` | |
| 86 | 86 | ||
| 87 | 87 | Only the author can edit or delete a comment. An admin can override that, and the | |
| @@ -91,9 +91,9 @@ an anchor for each one (`#c-<ulid>`). | |||
| 91 | 91 | You can attach a comment to a line on either side of the diff: | |
| 92 | 92 | ||
| 93 | 93 | ```sh | |
| 94 | vole request comment <id> -m "this drops the check" \ | ||
| 94 | vole change comment <id> -m "this drops the check" \ | ||
| 95 | 95 | --path internal/auth.go --line 88 | |
| 96 | vole request comment <id> -m "and this was the old line" \ | ||
| 96 | vole change comment <id> -m "and this was the old line" \ | ||
| 97 | 97 | --path internal/auth.go --line 88 --side old | |
| 98 | 98 | ``` | |
| 99 | 99 | ||