wiki: SSH keys page and the v1.23.0 changelog !397

merged merged by cmc on 2026-09-18 02:00 UTC · krz/gitbay:design-docs into main

5 files changed, +68 −0

Layout: unified · split

.gitbay/wiki/Admin.org +5
@@ -87,6 +87,11 @@ default, is right when gitbayd terminates TLS itself.
87 minted over SSH (=web login=), and users with write access can create 87 minted over SSH (=web login=), and users with write access can create
88 repos, comment, and make simple file edits (which commit unsigned, 88 repos, comment, and make simple file edits (which commit unsigned,
89 honestly). =password_auth= is reserved and currently rejected. 89 honestly). =password_auth= is reserved and currently rejected.
90- =title= — the instance's display name in the rail and page titles;
91 empty falls back to the site host. Lower case is the convention for
92 gitbay itself.
93- =privacy_notice= — operator text shown on =/privacy= under the fixed
94 statement.
90 95
91** [registration] 96** [registration]
92- =mode= — =closed= (default) | =invite= | =open=. invite/open require 97- =mode= — =closed= (default) | =invite= | =open=. invite/open require
.gitbay/wiki/Home.org +1
@@ -3,6 +3,7 @@
3CLI-first git forge: SSH is the API, the web is a rendering. 3CLI-first git forge: SSH is the API, the web is a rendering.
4 4
5- [[Quickstart][Quickstart]] — clone, push, first issue 5- [[Quickstart][Quickstart]] — clone, push, first issue
6- [[SSH-keys][SSH keys]] — make a key and find its public half
6- [[FAQ][FAQ]] — common questions from GitHub migrants 7- [[FAQ][FAQ]] — common questions from GitHub migrants
7- [[Users][User guide]] — accounts, keys, verified commits, repos, issues, MRs 8- [[Users][User guide]] — accounts, keys, verified commits, repos, issues, MRs
8- [[Stacked-MRs][Stacked merge requests]] — dependent merge requests, merged one layer at a time 9- [[Stacked-MRs][Stacked merge requests]] — dependent merge requests, merged one layer at a time
.gitbay/wiki/SSH-keys.org added +31
@@ -0,0 +1,31 @@
1#+title: SSH keys
2
3Your key is your identity on gitbay: there are no passwords. Registering
4pastes the public half of a key pair; the private half never leaves your
5machine.
6
7* Make a key
8
9#+begin_src sh
10ssh-keygen -t ed25519 -C "you@host"
11#+end_src
12
13Accept the default path. Two files land in =~/.ssh/=: =id_ed25519= is
14private, keep it; =id_ed25519.pub= is public, paste it.
15
16* Get the public half
17
18#+begin_src sh
19cat ~/.ssh/id_ed25519.pub
20#+end_src
21
22One line, starting =ssh-ed25519 AAAA…= and ending with your comment. That
23whole line is what the registration form and =register= want.
24
25* Check it works
26
27#+begin_src sh
28ssh git@<host> whoami
29#+end_src
30
31More keys, labels and scopes: [[Users][the user guide]] under "SSH keys".
.gitbay/wiki/Users.org +7
@@ -52,6 +52,8 @@ the terminal alone:
52 52
53* SSH keys 53* SSH keys
54 54
55New to SSH keys? [[SSH-keys]] makes one in two commands.
56
55Your key is your identity; there are no passwords anywhere. The SSH 57Your key is your identity; there are no passwords anywhere. The SSH
56username is always =git= — the key alone determines who you are. 58username is always =git= — the key alone determines who you are.
57 59
@@ -656,6 +658,11 @@ someone else.
656You are never mailed about your own actions, and only verified primary 658You are never mailed about your own actions, and only verified primary
657addresses receive anything. Delivery retries on relay failure. 659addresses receive anything. Delivery retries on relay failure.
658 660
661* Web vocabulary
662
663Sign in / Log out, Search, sentence-case headings and buttons, product
664name lowercase.
665
659* Output rules 666* Output rules
660 667
661=--json= is the contract; the plain output is for a person at a 668=--json= is the contract; the plain output is for a person at a
CHANGELOG.org +24
@@ -4,6 +4,30 @@ Versioning follows semver from v0.1.0. Database migrations run
4automatically on daemon start; upgrade notes appear per release when 4automatically on daemon start; upgrade notes appear per release when
5anything beyond "replace the binary and restart" is needed. 5anything beyond "replace the binary and restart" is needed.
6 6
7* v1.23.0 — unreleased
8
9The web design foundation (#218). Tokens measured in both schemes, one
10control family, content widths per page, and the landing, repository
11overview, merge request and settings pages recomposed. Set =[web]
12title= to =gitbay= in lower case; the templates already are.
13
14- =style.css= rewritten on tokens defined on =:root= and again for dark;
15 =TestTokenContrast= enforces the floors and
16 =TestEveryTemplateClassHasARule= that every template class has a rule.
17- Buttons are primary, secondary, quiet or destructive; one focus ring on
18 everything; success and error flashes share one shape.
19- Every page picks a width: wide for code, reading for lists and threads,
20 bounded for forms.
21- The repository header shows description and topics on the code tab
22 only; the overview leads with the file table and puts clone commands
23 and facts after the README; "Find file" is "Search code".
24- A merge request states who merged or closed it under its title and
25 explains an empty diff.
26- Repository settings are bounded rows with a consequence beside each
27 control, a saved flash, a rejected value kept, and topics as one field.
28- Landing copy says what the product is and where to go; the register
29 form says to paste the contents of the key file and links [[SSH-keys]].
30
7* v1.22.1 — 2026-09-13 31* v1.22.1 — 2026-09-13
8 32
9One merge gate fix. 33One merge gate fix.