The documentation site has a how-to guide for connecting Sortie to each existing tracker (/guides/connect-to-jira/, /guides/connect-to-github/, /guides/connect-to-linear/) but none for Gitea. This is the task-focused how-to, distinct from the integration tutorial and the adapter reference: the concrete steps to point Sortie at a Gitea instance and repository.
Add a connect-to-Gitea how-to guide to the guides section of docs.sortie-ai.com, parallel to the existing connect guides: configure a WORKFLOW.md that authenticates against a self-hosted Gitea, scopes the right issues, and reports status back. Cover creating an access token with the scopes the adapter needs, setting tracker.endpoint to the instance base URL, tracker.project as owner/repo, the active/terminal state mapping (including creating any state labels the workflow uses, if the state model is label-driven), scoping candidates with tracker.query_filter, and verifying the connection.
The configuration shown must match the adapter as implemented; use docs/gitea-adapter-notes.md as the authoritative source and link to the Gitea adapter reference page for the full field schema.
Verify: the guide walks a reader through a working Gitea WORKFLOW.md (token creation, endpoint, tracker.project, state mapping, query_filter, and verifying the connection), and links to the Gitea adapter reference.
The documentation site has a how-to guide for connecting Sortie to each existing tracker (
/guides/connect-to-jira/,/guides/connect-to-github/,/guides/connect-to-linear/) but none for Gitea. This is the task-focused how-to, distinct from the integration tutorial and the adapter reference: the concrete steps to point Sortie at a Gitea instance and repository.Add a connect-to-Gitea how-to guide to the guides section of docs.sortie-ai.com, parallel to the existing connect guides: configure a
WORKFLOW.mdthat authenticates against a self-hosted Gitea, scopes the right issues, and reports status back. Cover creating an access token with the scopes the adapter needs, settingtracker.endpointto the instance base URL,tracker.projectasowner/repo, the active/terminal state mapping (including creating any state labels the workflow uses, if the state model is label-driven), scoping candidates withtracker.query_filter, and verifying the connection.The configuration shown must match the adapter as implemented; use
docs/gitea-adapter-notes.mdas the authoritative source and link to the Gitea adapter reference page for the full field schema.Verify: the guide walks a reader through a working Gitea
WORKFLOW.md(token creation, endpoint,tracker.project, state mapping,query_filter, and verifying the connection), and links to the Gitea adapter reference.