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.
7171 `repo commit-file <owner>/.gitbay profile/README.md --ref main
7272 --message "add profile about" --file -` with the web's starter text
7373 (`# <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
75 admin is checked first in implementation; if it does not, the offer
76 is shown for users only.
74 reloads. Any other failure is shown and stops the flow. `repo create` accepts `<org>/.gitbay` from an org admin
75 (`resolveNewRepoOwner`, `internal/control/repo.go`), so the offer is
76 the same for users and organizations.
7777
7878Tests: `ProfileEdit.flags()` carries no `--about-format` or `--file`;
7979`saveProfile` sends no stdin; `Profile` decodes `about_path`; the
@@ -179,9 +179,10 @@ One MR alongside 1.3.0:
179179 a row for "build row names its commit" (cli yes, web yes, ios no);
180180 a sentence under the preview paragraph that the iOS preview is the
181181 app's own rendering and resolves no autolinks.
182- CHANGELOG, v1.31.0: the about file is `profile/README.{md,org,markdown}`
183 in `<owner>/.gitbay`, not `about.org`/`about.md`. The release notes
184 for v1.31.0 are edited to match with `release edit`.
182- The published v1.31.0 release notes give the about file as
183 `about.org` or `about.md`; they are edited with `release edit` to
184 `profile/README.md` or `profile/README.org`. The CHANGELOG entry for
185 v1.31.0 already names the right path and is unchanged.
185186
186187Later MRs flip rows as each release ships: the build rows at 1.4.0,
187188MR labels and filter by label at 1.4.0, the four preview rows at 1.5.0,