Commit fc12b3c9dc

fc12b3c9dc498e5c393c52356a1d4fa0e8799cc6

parent: 719e350092

Verified · cmc

cmc <hello@cleberg.net> · 2026-09-22 17:29 UTC

docs: settle the org create question and the release-note fix

Layout: unified · split

docs/superpowers/specs/2026-09-22-parity-followup-design.md +7 −6
@@ -71,9 +71,9 @@ form). The app does the same.
71 `repo commit-file <owner>/.gitbay profile/README.md --ref main 71 `repo commit-file <owner>/.gitbay profile/README.md --ref main
72 --message "add profile about" --file -` with the web's starter text 72 --message "add profile about" --file -` with the web's starter text
73 (`# <owner>\n\nThis is the about text on your profile.\n`), and 73 (`# <owner>\n\nThis is the about text on your profile.\n`), and
74 reloads. Any other failure is shown and stops the flow. Whether `repo create` accepts `<org>/.gitbay` from an org 74 reloads. Any other failure is shown and stops the flow. `repo create` accepts `<org>/.gitbay` from an org admin
75 admin is checked first in implementation; if it does not, the offer 75 (`resolveNewRepoOwner`, `internal/control/repo.go`), so the offer is
76 is shown for users only. 76 the same for users and organizations.
77 77
78Tests: `ProfileEdit.flags()` carries no `--about-format` or `--file`; 78Tests: `ProfileEdit.flags()` carries no `--about-format` or `--file`;
79`saveProfile` sends no stdin; `Profile` decodes `about_path`; the 79`saveProfile` sends no stdin; `Profile` decodes `about_path`; the
@@ -179,9 +179,10 @@ One MR alongside 1.3.0:
179 a row for "build row names its commit" (cli yes, web yes, ios no); 179 a row for "build row names its commit" (cli yes, web yes, ios no);
180 a sentence under the preview paragraph that the iOS preview is the 180 a sentence under the preview paragraph that the iOS preview is the
181 app's own rendering and resolves no autolinks. 181 app's own rendering and resolves no autolinks.
182- CHANGELOG, v1.31.0: the about file is `profile/README.{md,org,markdown}` 182- The published v1.31.0 release notes give the about file as
183 in `<owner>/.gitbay`, not `about.org`/`about.md`. The release notes 183 `about.org` or `about.md`; they are edited with `release edit` to
184 for v1.31.0 are edited to match with `release edit`. 184 `profile/README.md` or `profile/README.org`. The CHANGELOG entry for
185 v1.31.0 already names the right path and is unchanged.
185 186
186Later MRs flip rows as each release ships: the build rows at 1.4.0, 187Later MRs flip rows as each release ships: the build rows at 1.4.0,
187MR labels and filter by label at 1.4.0, the four preview rows at 1.5.0, 188MR labels and filter by label at 1.4.0, the four preview rows at 1.5.0,