kandev/docs/plans/github-authentication/task-20-registration-documentation.md

id, title, status, wave, depends_on, plan, spec

id	title	status	wave	depends_on	plan	spec
20-registration-documentation	Registration documentation	done	7	18-workspace-authentication-ux	plan.md	../../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

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.