Uh oh!
There was an error while loading. Please reload this page.
Draft Findings and Decoys docs - #456
Open
mindymo wants to merge 21 commits into
Open
Conversation
…vers, group AI agent governance Rough pass at a new admin-guide structure to make room for the upcoming Shadow AI Discovery, Agentic Vault, Agent Runtime Governance, and Agentic Security & Intelligence features alongside the existing AI access management, enterprise-managed authorization, and cloud infrastructure access sections. Splits end-user guides into their own top-level tab and promotes MCP server setup guides out of a nested subgroup. Not for merge yet — several referenced pages don't exist. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…tion Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Adds a new card for the Use C1 tab and renames the Products card to Administer C1, matching the reframed IA in this draft. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Adds an overview page for the Use C1 tab, organized around what readers are trying to do rather than a list of feature names, with a first-time quickstart, admin-side disambiguation, and an FAQ. Points the homepage's Use C1 card and the tab's Overview group at it. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Recolors Administer C1 pink and Developer teal so the 2x3 grid checkerboards, and swaps the Use C1 / Administer C1 card icons to the same compass/gear icons used for their nav tabs. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
The hand-drawn compass/gear paths rendered broken in preview. Swap to Mintlify's Icon component with the same icon names used for the Use C1 / Administer C1 tabs. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- Fix gerund parallelism: "Administer C1" -> "Administering C1" in the audience-disambiguation Tip - Collapse the first-time-in-C1 Steps into a collapsed Accordion so it doesn't push task cards below the fold - Move "What are you trying to do?" up to follow the intro/Tip - Retitle the AI tools card to lead with the task, not MCP jargon - Retitle the approval card to avoid overloading "complete" - Trim the redundant FAQ heading - Tighten generic step copy to match the opening line's specificity - Switch card icons to the duotone variant Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
# Conflicts: # docs.json
# Conflicts: # docs.json # product/how-to/intro.mdx
Findings: enabling finding types, working a finding, transformation and routing rules, rule ordering guidance, and a worked example chaining a transformation rule with a routing rule. Decoys: planting, managing, and what happens when a decoy is used, including the audit-trail-survives-a-toggle nuance and the finding types it produces. Also documents the "... (more actions) menu" convention in the docs-writing skill. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Contributor
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Standalone early-access entries, JTBD-framed per house style, linking to the new docs pages drafted earlier in this branch. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Split sentences held together by em dashes, colons, or comma chains into shorter standalone sentences across findings.mdx, decoys.mdx, and the release notes entry. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
The decoy-credential walkthrough and the decoy-planting steps each had multiple actions (navigate, set fields, save) bundled into single steps. Broken out into individual steps per the docs style guide's one-action-per-step rule. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
product/admin/findings.mdx: enabling finding types, working a finding, transformation and routing rules, rule-ordering guidance, and a worked example (decoy credential detection → escalation).product/admin/decoys.mdx: planting/managing decoys, and what happens when one is used (Critical severity, audit trail survives a finding-type toggle, the Attempts table).**...** (more actions) menuconvention in the docs-writing skill.Both pages are marked early access and were reverse-engineered from screenshots plus the
c1source (proto, controller, and frontend code) since the primary dev was unavailable this week — draft is meant for his review, not final.Open questions
CreateAccessTokenForm's request filter appears to restrict selection to service-principal users only. Intentional, or should human users be selectable too? Docs currently just say "an existing user."disabledfield yet, and "Phase-3 fire-hook will honor Decoy.disabled directly for AT decoys" — implying Disable may not fully stop an access-token decoy today the way it does for the others. Should we caveat this in the docs, or has it shipped since that comment was written?FeatureFlagIdDecoysin addition to the Super Admin role gate — live for all Super Admins today, or still limited to specific tenants?Test plan
docs.jsonnav entries forfindingsanddecoys(already merged indocs-ia-reframe-draft) still match this content