[Docs] Document Sprint 3: archive behavior, issue filters, API contract updates

[mpaulosky]

Summary

Document the Sprint 3 changes — archive behavior, issue filter/search semantics, and any API contract changes — so that future contributors understand these features without reading the code.

Sections to Write / Update

1. docs/features/issues.md (update)

• Document the filter/search params now supported by GET /api/v1/issues
  • page, pageSize, searchTerm, statusName, categoryName
• Clarify that CreateIssueCommand and UpdateIssueCommand accept all fields (Title, Description, CategoryId, StatusId)
• Note: comments are fetched filtered by issueId — not a full-collection load

2. docs/features/categories.md (update or create)

• Document DELETE /api/v1/categories/{id} (Admin-only)
• Explain soft-delete / archive behavior: Archived=true, ArchivedBy, ArchivedOn
• Explain that archived categories do not appear in issue creation forms

3. docs/features/statuses.md (update or create)

• Same as categories — document DELETE /api/v1/statuses/{id}
• Explain soft-delete behavior

4. docs/architecture/api-contracts.md (update if exists)

• Reflect any new query params or request body fields added in Sprint 3

5. CHANGELOG.md (update)

• Add Sprint 3 entries under the appropriate version section:
  • Fixed: IssuesPage filter wiring
  • Fixed: CreateIssue / UpdateIssue command field mapping
  • Fixed: IssueDetail comment performance
  • Added: Category archive (API + UI)
  • Added: Status archive (API + UI)

Acceptance Criteria

• All new API endpoints are documented with method, path, auth requirement, params, and response
• Archive behavior explained in plain language for Categories and Statuses
• CHANGELOG updated with all Sprint 3 changes
• Docs written so a new contributor can understand the feature without reading source

Depends On

All Sprint 3 implementation issues (#116–#127)

[github-actions]

📋 Assigned to Frodo (Tech Writer)

Issue: #128 — [Docs] Document Sprint 3: archive behavior, issue filters, API contract updates

Frodo will pick this up in the next Copilot session.

For Copilot coding agent: If enabled, this issue will be worked automatically.
Otherwise, start a Copilot session and say:
Frodo, work on issue #128

[github-actions]

🏗️ Squad Triage — Aragorn (Lead)

Issue: #128 — [Docs] Document Sprint 3: archive behavior, issue filters, API contract updates
Assigned to: Legolas (Frontend Dev)
Reason: Issue relates to frontend/UI work

@copilot evaluation: 🔴 Not suitable — issue involves work outside the coding agent's capability profile.

Team roster:

• Aragorn (Lead) → label: squad:aragorn
• Legolas (Frontend Dev) → label: squad:legolas
• Sam (Backend Dev) → label: squad:sam
• Gimli (Tester) → label: squad:gimli
• Boromir (DevOps) → label: squad:boromir
• Frodo (Tech Writer) → label: squad:frodo
• Gandalf (Security Officer) → label: squad:gandalf
• Ralph (Work Monitor) → label: squad:ralph
• @copilot (🤖 Coding Agent) → label: squad:@copilot
• @copilot (Coding Agent) → label: squad:copilot

To reassign, remove the current squad:* label and add the correct one.

[github-actions]

📋 Marked as release:backlog — assign a release target when ready.