docs: Gitea-Dependency-Aufruf nach Verifikation korrigieren
Der Endpoint war als ungeprueft markiert. Beim Verdrahten der ersten
Wayfinder-Map hat sich gezeigt: owner und repo muessen im Body wiederholt
werden, der Pfad allein reicht nicht. Ohne sie schlaegt der Aufruf mit
"repository does not exist [owner_name: ]" fehl, was in eine falsche Richtung
zeigt. Die von tea dokumentierten {owner}/{repo}-Platzhalter werden hier
ebenfalls nicht ersetzt.
This commit is contained in:
@@ -64,12 +64,18 @@ Used by `/wayfinder`. The **map** is a single issue with **child** issues as tic
|
|||||||
Gitea 1.24+ has native sub-issues, but `tea` does not expose them — the `Part of #<map>`
|
Gitea 1.24+ has native sub-issues, but `tea` does not expose them — the `Part of #<map>`
|
||||||
line is the convention here, and Gitea renders it as a cross-reference on the map.
|
line is the convention here, and Gitea renders it as a cross-reference on the map.
|
||||||
- **Blocking**: Gitea has **native issue dependencies**, which is what renders the frontier in
|
- **Blocking**: Gitea has **native issue dependencies**, which is what renders the frontier in
|
||||||
the web UI. `tea` does not wrap them, so use the API:
|
the web UI. `tea` does not wrap them, so use the API — **verified working**:
|
||||||
`tea api --method POST repos/RDietermann/dionotes-client/issues/<child>/dependencies -d '{"index": <blocker>}'`.
|
|
||||||
Read them back with `tea api repos/RDietermann/dionotes-client/issues/<child>/dependencies`.
|
```bash
|
||||||
**Unverified** — the first session to wire a blocking edge should confirm this endpoint
|
tea api "repos/RDietermann/dionotes-client/issues/<child>/dependencies" \
|
||||||
works and fix this line. If it does not, fall back to a `Blocked by: #<n>, #<n>` line at the
|
-F index=<blocker> -f owner=RDietermann -f repo=dionotes-client
|
||||||
top of the description. A ticket is unblocked when every blocker is closed.
|
```
|
||||||
|
|
||||||
|
The body must repeat `owner` and `repo` — the path alone is not enough, and omitting them
|
||||||
|
fails with a misleading `repository does not exist [owner_name: ]`. The `{owner}`/`{repo}`
|
||||||
|
placeholders `tea api` documents do **not** get substituted here either; write them out.
|
||||||
|
Read the blockers back with a plain GET on the same path. A ticket is unblocked when every
|
||||||
|
blocker is closed.
|
||||||
- **Frontier query**: `tea issues ls --output json --labels wayfinder:grilling,wayfinder:research,wayfinder:prototype,wayfinder:task`,
|
- **Frontier query**: `tea issues ls --output json --labels wayfinder:grilling,wayfinder:research,wayfinder:prototype,wayfinder:task`,
|
||||||
keep those whose body says `Part of #<map>`, drop any with an assignee (claimed) or an open
|
keep those whose body says `Part of #<map>`, drop any with an assignee (claimed) or an open
|
||||||
blocker; first in map order wins.
|
blocker; first in map order wins.
|
||||||
|
|||||||
Reference in New Issue
Block a user