docs(tracker): correct the Gitea native-dependency API call

The wayfinding doc pointed at a .../dependencies/blocked_by subpath
that 404s, and the working call needs the blocker's owner+repo in the
JSON body (omitting them 404s with 'repository does not exist').
Verified against Gitea 1.27: POST/DELETE .../issues/<child>/dependencies
with {"index", "owner", "repo"}.
This commit is contained in:
Cameron Cordes committed 2026-09-25 16:17:17 -04:00
1 parent 467abd41d5
commit 6f73a31e08
1 file changed
+13 -6
+13 -6
View File
@@ -68,12 +68,19 @@ as tickets.
dev. dev.
- **Blocking**: Gitea's **native issue dependencies** (enabled on this - **Blocking**: Gitea's **native issue dependencies** (enabled on this
server), the canonical, UI-visible representation. Add an edge with server), the canonical, UI-visible representation. Add an edge with
`tea api --method POST repos/{owner}/{repo}/issues/<child>/dependencies/blocked_by -F issue_id=<blocker-issue-index>` `tea api --method POST repos/{owner}/{repo}/issues/<child>/dependencies -d '{"index": <blocker-index>, "owner": "<owner>", "repo": "<repo>"}'`
(the Gitea dependencies API takes the issue index, i.e. the visible (201 on success). Gotchas, verified against Gitea 1.27:
`#number`, not an internal database id). Where dependencies aren't - The route is `.../dependencies` — there is **no** `blocked_by`
available, fall back to a `Blocked by: #<n>, #<n>` line at the top of subpath (that 404s).
the child description. A ticket is unblocked when every blocker is - The JSON body **must** name the blocker's repo (`owner` + `repo`);
closed. omitting them yields a misleading `404 repository does not exist`
even though the child's path is correct.
- `index` is the visible `#number`, not an internal database id.
Verify with `tea api repos/{owner}/{repo}/issues/<child>/dependencies`
(lists blockers); remove with `--method DELETE` and the same body.
Where dependencies aren't available, fall back to a
`Blocked by: #<n>, #<n>` line at the top of the child description.
A ticket is unblocked when every blocker is closed.
- **Frontier query**: list the map's open children (issues whose - **Frontier query**: list the map's open children (issues whose
description carries `Part of #<map>`), drop any with an open blocker description carries `Part of #<map>`), drop any with an open blocker
(dependency or `Blocked by` line) or an assignee; first in map order wins. (dependency or `Blocked by` line) or an assignee; first in map order wins.