Carlos Florêncio
52 lines
1.5 KiB
Markdown
52 lines
1.5 KiB
Markdown
---
|
|
id: "20-registration-documentation"
|
|
title: "Registration documentation"
|
|
status: done
|
|
wave: 7
|
|
depends_on: ["18-workspace-authentication-ux"]
|
|
plan: "plan.md"
|
|
spec: "../../specs/integrations/requirements/github-authentication.md"
|
|
---
|
|
|
|
# Task 20: Registration Documentation
|
|
|
|
## Acceptance
|
|
|
|
1. Public docs explain PAT/CLI/App choice, known/import/create paths, strict versus shared App
|
|
isolation, private/public meaning, exact callbacks/webhooks, and permissions; the unpublished App
|
|
environment variables and instructions are absent.
|
|
2. Architecture and scoped agent guidance no longer claim a singleton deployment App or System
|
|
Settings ownership.
|
|
3. Generated documentation coverage metadata is updated using the repository's supported command.
|
|
|
|
## Verification
|
|
|
|
```bash
|
|
test -z "$(rg -l 'single deployment GitHub App|one deployment App|System Settings > GitHub App|KANDEV_GITHUB_APP' docs/public docs/ARCHITECTURE.md apps/backend/AGENTS.md || true)"
|
|
git diff --check
|
|
```
|
|
|
|
## Files Likely Touched
|
|
|
|
- `docs/public/integrations.md`
|
|
- `docs/public/configuration.md`
|
|
- `docs/public/feature-status.md`
|
|
- `docs/public/coverage.json`
|
|
- `docs/ARCHITECTURE.md`
|
|
- `apps/backend/AGENTS.md`
|
|
|
|
## Dependencies
|
|
|
|
Task 18.
|
|
|
|
## Inputs
|
|
|
|
- Spec and new ADR.
|
|
- Final endpoint names and UX terminology from Tasks 16 and 18.
|
|
- Invoke docs-maintainer; use primary GitHub documentation links already present in the repo.
|
|
|
|
## Output Contract
|
|
|
|
Report documentation/metadata changes, verification run, files touched, blockers/risks, and update
|
|
this task plus `plan.md` to done.
|