Commit `0a69a8facd`

0a69a8facd64e67e42ec04fa11dd4a0304e40d79

Verified · cmc

cmc <hello@cleberg.net> · 2026-09-12 01:01 UTC

wiki, CHANGELOG: snippets

Closes #195

.gitbay/wiki/Admin.org +1

		@@ -114,6 +114,7 @@ default, is right when gitbayd terminates TLS itself.
114	114	- =clone_timeout= (3600s) — cap on =repo import= fetches.
115	115	- =max_blob_bytes= (100MB) — cap on raw file serving over the web.
116	116	- =max_asset_bytes= (512MB) — cap per uploaded release asset.
	117	- =max_snippet_bytes= (1MB) — cap per snippet file.
117	118	- =max_repos_per_user= (0, unlimited) — repositories an account may own
118	119	directly; =repo create=, =fork= and =import= refuse past it.
119	120	Organizations are not capped.

.gitbay/wiki/Parity.org +3

		@@ -192,6 +192,9 @@ always markdown.
192	192	\| release delete \| yes \| yes \| yes \|
193	193	\| release asset add \| yes \| no \| n/a \|
194	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	199	No row is web-only any more. Blame, file editing, log at a ref,
197	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	601	instance; unverified claims serve nothing and expire after 7 days.
602	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	630	* Browser sessions
605	631
606	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	4	automatically on daemon start; upgrade notes appear per release when
5	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	23	* v1.19.0 — 2026-09-11
8	24
9	25	Labels and milestones an org defines once for every repository under

Commit 0a69a8facd