docs: Encourage tea CLI for opening MRs

Replaces the "do not use tea/gh/Gitea API" rule with explicit guidance to
run `tea pr create` and print the resulting PR URL. tea is already
authenticated on this machine. Merging stays a manual user action in
Gitea — neither tea nor git CLI may merge or delete branches.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
2026-05-05 22:41:05 +02:00
parent 20ade6de3e
commit 6ca35e2112

View File

@@ -105,12 +105,23 @@ request flow:
2. **Commit on the branch** following the existing commit conventions 2. **Commit on the branch** following the existing commit conventions
(Co-Authored-By trailer, etc.). (Co-Authored-By trailer, etc.).
3. **Push the branch** to `origin` with `-u` so it tracks. 3. **Push the branch** to `origin` with `-u` so it tracks.
4. **Print the Gitea compare URL** so the user can open the MR in the browser: 4. **Open the MR with `tea`** rather than printing a compare URL:
`https://gitea.home.hrajfrisbee.cz/kacerr/fuj-management/compare/main...<branch>`
Do **not** use `tea`, `gh`, or call the Gitea API — the user opens and ```bash
merges the MR themselves. tea pr create \
5. **Do not merge or delete the branch** from the CLI. The user does that --title "<short title>" \
in Gitea. --description "<body>" \
--base main \
--head <branch>
```
`tea` is already authenticated against the Gitea instance; just run it.
Print the resulting PR URL for the user. If `tea` is unavailable for
some reason, fall back to printing the compare URL
(`https://gitea.home.hrajfrisbee.cz/kacerr/fuj-management/compare/main...<branch>`)
and let the user open the MR manually.
5. **Do not merge or delete the branch** from the CLI — neither via `tea`,
`gh`, nor `git push --delete`. The user does that in Gitea.
**Exceptions — when committing straight to `main` is fine:** **Exceptions — when committing straight to `main` is fine:**
- Small bug fixes / hotfixes the user describes as such. - Small bug fixes / hotfixes the user describes as such.