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:
1 parent
467abd41d5
commit
6f73a31e08
1 file changed
+13
-6
@@ -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.
|
||||||
|
|||||||
Reference in new issue
Block a user