Skip to content

docs: expand Concepts section and add Local Auth page#96

Open
nsaronson wants to merge 1 commit intomainfrom
docs/concepts-gaps-and-organization
Open

docs: expand Concepts section and add Local Auth page#96
nsaronson wants to merge 1 commit intomainfrom
docs/concepts-gaps-and-organization

Conversation

@nsaronson
Copy link
Contributor

Summary

  • Rewrite concepts/resource-roles.mdx — replaces generic marketing copy with accurate technical detail: type/subtype tables, base64-encoded credential format in the secret object, agent binding via agent_id, access modes, and feature-to-plugin mapping
  • New concepts/sessions.mdx — covers session lifecycle (openreadydone), what each state means in the access request flow, what is recorded per session, and visibility rules by role
  • New concepts/plugins.mdx — explains per-connection plugin attachment, the default plugin set (audit, dlp, review, slack), full plugin reference table, and the review/dlp managed-by-connection behavior
  • New setup/configuration/idp/local-auth.mdx — documents first-user-becomes-admin behavior, invitation flow, AUTH_METHOD=local env var, and transitioning to OIDC/SAML
  • Update setup/configuration/idp/get-started.mdx — adds Local Auth card to the provider CardGroup
  • Update docs.json — adds sessions, plugins, and local-auth to navigation

Test plan

  • npm run dev — verify all 3 new Concepts pages render without errors
  • Verify concepts/sessions, concepts/plugins appear in the Concepts nav group
  • Verify setup/configuration/idp/local-auth appears first in the Identity Providers nav group
  • Verify Local Auth card appears on the IDP get-started page and links correctly
  • Check internal links in new pages (/concepts/plugins, /learn/features/*, /integrations/slack, etc.)

🤖 Generated with Claude Code

- Rewrite concepts/resource-roles.mdx with accurate type/subtype tables,
  credential format, agent binding, access modes, and feature-plugin mapping
- Add concepts/sessions.mdx covering lifecycle states, recorded data, and
  visibility rules by role
- Add concepts/plugins.mdx with default plugin set, full plugin reference,
  and managed-by-connection behavior for review and dlp
- Add setup/configuration/idp/local-auth.mdx covering first-user-admin flow,
  invite model, AUTH_METHOD env var, and transitioning to OIDC/SAML
- Update IDP get-started.mdx to add Local Auth card to CardGroup
- Update docs.json to add sessions, plugins, and local-auth to navigation

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@netlify
Copy link

netlify bot commented Mar 3, 2026

Deploy Preview for decap-documentation ready!

Name Link
🔨 Latest commit 86544e4
🔍 Latest deploy log https://app.netlify.com/projects/decap-documentation/deploys/69a63043715ba00008c4a8a6
😎 Deploy Preview https://deploy-preview-96--decap-documentation.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant