584608a14e
Cherry-picked website/, scripts/generate-llms-full.sh, and deploy-docs.yml from joyshmitz's PR. Fixed workflow to trigger on main branch instead of docs/docusaurus-site. Features: - Docusaurus documentation site with llms.txt support - Environment-variable driven config (defaults to steveyegge org) - Automated llms-full.txt generation from docs - GitHub Pages deployment workflow Co-authored-by: joyshmitz <joyshmitz@users.noreply.github.com> 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> Executed-By: beads/crew/dave Rig: beads Role: crew
126 lines
2.3 KiB
Markdown
126 lines
2.3 KiB
Markdown
---
|
|
id: labels
|
|
title: Labels & Comments
|
|
sidebar_position: 5
|
|
---
|
|
|
|
# Labels & Comments
|
|
|
|
Commands for managing labels and comments.
|
|
|
|
## Labels
|
|
|
|
### Adding Labels
|
|
|
|
```bash
|
|
# During creation
|
|
bd create "Task" -l "backend,urgent"
|
|
|
|
# To existing issue
|
|
bd update bd-42 --add-label urgent
|
|
bd update bd-42 --add-label "backend,security"
|
|
```
|
|
|
|
### Removing Labels
|
|
|
|
```bash
|
|
bd update bd-42 --remove-label urgent
|
|
```
|
|
|
|
### Listing Labels
|
|
|
|
```bash
|
|
# All labels in use
|
|
bd label list
|
|
bd label list --json
|
|
|
|
# Issues with specific labels
|
|
bd list --label-any urgent,critical
|
|
bd list --label-all backend,security
|
|
```
|
|
|
|
### Label Conventions
|
|
|
|
Suggested label categories:
|
|
|
|
| Category | Examples | Purpose |
|
|
|----------|----------|---------|
|
|
| Type | `bug`, `feature`, `docs` | Issue classification |
|
|
| Priority | `urgent`, `critical` | Urgency markers |
|
|
| Area | `backend`, `frontend`, `api` | Code area |
|
|
| Status | `blocked`, `needs-review` | Workflow state |
|
|
| Size | `small`, `medium`, `large` | Effort estimate |
|
|
|
|
## Comments
|
|
|
|
### Adding Comments
|
|
|
|
```bash
|
|
bd comment add bd-42 "Working on this now"
|
|
bd comment add bd-42 --message "Found the bug in auth.go:45"
|
|
```
|
|
|
|
### Listing Comments
|
|
|
|
```bash
|
|
bd comment list bd-42
|
|
bd comment list bd-42 --json
|
|
```
|
|
|
|
### Viewing with Issue
|
|
|
|
```bash
|
|
bd show bd-42 --full # Includes comments
|
|
```
|
|
|
|
## Filtering by Labels
|
|
|
|
### Any Match (OR)
|
|
|
|
```bash
|
|
# Issues with urgent OR critical
|
|
bd list --label-any urgent,critical
|
|
```
|
|
|
|
### All Match (AND)
|
|
|
|
```bash
|
|
# Issues with BOTH backend AND security
|
|
bd list --label-all backend,security
|
|
```
|
|
|
|
### Combined Filters
|
|
|
|
```bash
|
|
# Open bugs with urgent label
|
|
bd list --status open --type bug --label-any urgent --json
|
|
```
|
|
|
|
## Bulk Operations
|
|
|
|
### Add Label to Multiple Issues
|
|
|
|
```bash
|
|
# Using shell
|
|
for id in bd-42 bd-43 bd-44; do
|
|
bd update $id --add-label "sprint-1"
|
|
done
|
|
```
|
|
|
|
### Find and Label
|
|
|
|
```bash
|
|
# Label all open bugs as needs-triage
|
|
bd list --status open --type bug --json | \
|
|
jq -r '.[].id' | \
|
|
xargs -I {} bd update {} --add-label needs-triage
|
|
```
|
|
|
|
## Best Practices
|
|
|
|
1. **Keep labels lowercase** - `backend` not `Backend`
|
|
2. **Use hyphens for multi-word** - `needs-review` not `needs_review`
|
|
3. **Be consistent** - Establish team conventions
|
|
4. **Don't over-label** - 2-4 labels per issue is typical
|
|
5. **Review periodically** - Remove unused labels
|