28 lines
1.1 KiB
Markdown
28 lines
1.1 KiB
Markdown
# Issue tracker: Gitea
|
|
|
|
Issues and specs for this repo live as Gitea issues. Use the official [`tea`](https://gitea.com/gitea/tea) CLI for all operations.
|
|
|
|
## Conventions
|
|
|
|
- **Create an issue**: `tea issues create --title "..." --description "..."`.
|
|
- **Read an issue**: `tea issues <number>`.
|
|
- **List issues**: `tea issues`; use `tea issues --state all` for all states and `tea issues --format json` for machine-readable output.
|
|
- **Comment on an issue**: `tea comment issue <number>`.
|
|
- **Apply / remove labels**: `tea issues edit <number> --add-labels "..."` / `--remove-labels "..."`.
|
|
- **Close**: `tea issues close <number>`.
|
|
- **Pull requests**: use `tea pulls create`, `tea pulls <number>`, and `tea pulls checkout <number>`.
|
|
|
|
Configure the Gitea instance with `tea login add`. `tea` uses repository context from the current clone when available.
|
|
|
|
## Merge requests as a triage surface
|
|
|
|
**Pull requests as a request surface: no.**
|
|
|
|
## When a skill says "publish to the issue tracker"
|
|
|
|
Create a Gitea issue.
|
|
|
|
## When a skill says "fetch the relevant ticket"
|
|
|
|
Run `tea issues <number>`.
|