Commit 0a69a8facd
0a69a8facd64e67e42ec04fa11dd4a0304e40d79
parent: a21d67902c
Verified · cmc
cmc <hello@cleberg.net> · 2026-09-12 01:01 UTC
wiki, CHANGELOG: snippets
Closes #195
Layout: unified · split
.gitbay/wiki/Admin.org
+1
| @@ -114,6 +114,7 @@ default, is right when gitbayd terminates TLS itself. |
| 114 | - =clone_timeout= (3600s) — cap on =repo import= fetches. |
114 | - =clone_timeout= (3600s) — cap on =repo import= fetches. |
| 115 | - =max_blob_bytes= (100MB) — cap on raw file serving over the web. |
115 | - =max_blob_bytes= (100MB) — cap on raw file serving over the web. |
| 116 | - =max_asset_bytes= (512MB) — cap per uploaded release asset. |
116 | - =max_asset_bytes= (512MB) — cap per uploaded release asset. |
| |
117 | - =max_snippet_bytes= (1MB) — cap per snippet file. |
| 117 | - =max_repos_per_user= (0, unlimited) — repositories an account may own |
118 | - =max_repos_per_user= (0, unlimited) — repositories an account may own |
| 118 | directly; =repo create=, =fork= and =import= refuse past it. |
119 | directly; =repo create=, =fork= and =import= refuse past it. |
| 119 | Organizations are not capped. |
120 | Organizations are not capped. |
.gitbay/wiki/Parity.org
+3
| @@ -192,6 +192,9 @@ always markdown. |
| 192 | | release delete | yes | yes | yes | |
192 | | release delete | yes | yes | yes | |
| 193 | | release asset add | yes | no | n/a | |
193 | | release asset add | yes | no | n/a | |
| 194 | | release asset remove | yes | no | yes | |
194 | | release asset remove | yes | no | yes | |
| |
195 | | snippet create, edit, delete| yes | yes | no | |
| |
196 | | snippet show, list | yes | yes | no | |
| |
197 | | snippet file set, get, remove| yes | yes | no | |
| 195 | |
198 | |
| 196 | No row is web-only any more. Blame, file editing, log at a ref, |
199 | No row is web-only any more. Blame, file editing, log at a ref, |
| 197 | archive, the public listing and the wiki were all in that state — a |
200 | archive, the public listing and the wiki were all in that state — a |
.gitbay/wiki/Users.org
+26
| @@ -601,6 +601,32 @@ instance issues its own certificates). Claims are exclusive per |
| 601 | instance; unverified claims serve nothing and expire after 7 days. |
601 | instance; unverified claims serve nothing and expire after 7 days. |
| 602 | =repo domain list= reports pending/verified/expired. |
602 | =repo domain list= reports pending/verified/expired. |
| 603 | |
603 | |
| |
604 | * Snippets |
| |
605 | |
| |
606 | A snippet is one or more named text files you own outside any |
| |
607 | repository, for a log or a fragment shared by URL. Create one from a |
| |
608 | file on stdin; the reply is the id and the URL: |
| |
609 | |
| |
610 | #+begin_src sh |
| |
611 | gitbay snippet create build.log --description "failing build" < build.log |
| |
612 | gitbay snippet file set <id> notes.txt < notes.txt # add or replace a file |
| |
613 | gitbay snippet file get <id> build.log > build.log |
| |
614 | gitbay snippet edit <id> --visibility public |
| |
615 | gitbay snippet list # yours |
| |
616 | gitbay snippet list <owner> # their public ones |
| |
617 | gitbay snippet delete <id> |
| |
618 | #+end_src |
| |
619 | |
| |
620 | Visibility is =public= (listed on your page), =unlisted= (anyone with |
| |
621 | the URL, listed nowhere; the default) or =private= (you alone; not |
| |
622 | found to everyone else). Files are text, valid UTF-8, each under the |
| |
623 | instance's =max_snippet_bytes=, at most 64 per snippet. A snippet keeps |
| |
624 | at least one file. There is no history: setting a file replaces it. |
| |
625 | |
| |
626 | On the web, =/<you>/-/snippets= lists yours, each snippet page renders |
| |
627 | its files with a raw link per file, and the same page creates, edits |
| |
628 | and deletes through the commands above. |
| |
629 | |
| 604 | * Browser sessions |
630 | * Browser sessions |
| 605 | |
631 | |
| 606 | =gitbay web login= mints a one-time URL; the session it opens lasts |
632 | =gitbay web login= mints a one-time URL; the session it opens lasts |
CHANGELOG.org
+16
| @@ -4,6 +4,22 @@ Versioning follows semver from v0.1.0. Database migrations run |
| 4 | automatically on daemon start; upgrade notes appear per release when |
4 | automatically on daemon start; upgrade notes appear per release when |
| 5 | anything beyond "replace the binary and restart" is needed. |
5 | anything beyond "replace the binary and restart" is needed. |
| 6 | |
6 | |
| |
7 | * v1.20.0 — unreleased |
| |
8 | |
| |
9 | Snippets (#195): named text files a user owns outside any repository, |
| |
10 | shared by URL and edited in place. |
| |
11 | |
| |
12 | - Migration 0053: =snippets= and =snippet_files=. |
| |
13 | - =snippet create|show|list|edit|delete= and =snippet file |
| |
14 | set|get|remove=. Files are UTF-8 under =limits.max_snippet_bytes= |
| |
15 | (1MB), at most 64 per snippet; a snippet keeps at least one. |
| |
16 | Visibility =public=, =unlisted= (default) or =private=; a private |
| |
17 | snippet is not found to everyone but its owner and admins. |
| |
18 | - Web: =/<owner>/-/snippets= lists, each snippet page renders its |
| |
19 | files with a raw route per file, and the owner creates, edits and |
| |
20 | deletes from the page through the same commands. The owner page |
| |
21 | links to the list. |
| |
22 | |
| 7 | * v1.19.0 — 2026-09-11 |
23 | * v1.19.0 — 2026-09-11 |
| 8 | |
24 | |
| 9 | Labels and milestones an org defines once for every repository under |
25 | Labels and milestones an org defines once for every repository under |