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 @@ |
| 3 | CLI-first git forge: SSH is the API, the web is a rendering. |
3 | CLI-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 | |
| |
3 | Your key is your identity on gitbay: there are no passwords. Registering |
| |
4 | pastes the public half of a key pair; the private half never leaves your |
| |
5 | machine. |
| |
6 | |
| |
7 | * Make a key |
| |
8 | |
| |
9 | #+begin_src sh |
| |
10 | ssh-keygen -t ed25519 -C "you@host" |
| |
11 | #+end_src |
| |
12 | |
| |
13 | Accept the default path. Two files land in =~/.ssh/=: =id_ed25519= is |
| |
14 | private, keep it; =id_ed25519.pub= is public, paste it. |
| |
15 | |
| |
16 | * Get the public half |
| |
17 | |
| |
18 | #+begin_src sh |
| |
19 | cat ~/.ssh/id_ed25519.pub |
| |
20 | #+end_src |
| |
21 | |
| |
22 | One line, starting =ssh-ed25519 AAAA…= and ending with your comment. That |
| |
23 | whole line is what the registration form and =register= want. |
| |
24 | |
| |
25 | * Check it works |
| |
26 | |
| |
27 | #+begin_src sh |
| |
28 | ssh git@<host> whoami |
| |
29 | #+end_src |
| |
30 | |
| |
31 | More 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 | |
| |
55 | New to SSH keys? [[SSH-keys]] makes one in two commands. |
| |
56 | |
| 55 | Your key is your identity; there are no passwords anywhere. The SSH |
57 | Your key is your identity; there are no passwords anywhere. The SSH |
| 56 | username is always =git= — the key alone determines who you are. |
58 | username is always =git= — the key alone determines who you are. |
| 57 | |
59 | |
| @@ -656,6 +658,11 @@ someone else. |
| 656 | You are never mailed about your own actions, and only verified primary |
658 | You are never mailed about your own actions, and only verified primary |
| 657 | addresses receive anything. Delivery retries on relay failure. |
659 | addresses receive anything. Delivery retries on relay failure. |
| 658 | |
660 | |
| |
661 | * Web vocabulary |
| |
662 | |
| |
663 | Sign in / Log out, Search, sentence-case headings and buttons, product |
| |
664 | name 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 |
| 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.23.0 — unreleased |
| |
8 | |
| |
9 | The web design foundation (#218). Tokens measured in both schemes, one |
| |
10 | control family, content widths per page, and the landing, repository |
| |
11 | overview, merge request and settings pages recomposed. Set =[web] |
| |
12 | title= 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 | |
| 9 | One merge gate fix. |
33 | One merge gate fix. |