Repository navigation
docs: align Discover Snyk guides with the new navigation - #1923
VeronicaSnyk wants to merge 6 commits into
Conversation
…w navigation Rewrite 20 classic-navigation pages to the new-navigation paths verified against app.snyk.io, retag 4 pages with no app navigation as agnostic, and remove the classic banner from all 24. Correct the scope selector, Inventory, and Settings lists in Navigate the Snyk Web UI, and fix GitHub copy-paste errors and BitBucket spelling in the SCM setup pages. Unverified locations carry [ACTION REQUIRED] markers. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
✅ Snyk checks have passed. No issues have been found so far.
💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse. |
There was a problem hiding this comment.
AI review
No style or structural issues found in the updated navigation procedures.
Verified: all 25 modified documentation pages across discover-snyk resolve on docs.snyk.io with HTTP 200 · navigation paths systematically align with the new navigation architecture defined in navigate-the-snyk-web-ui.md (top scope selector for Tenant, Group, and Organization; unified side menu; Settings hierarchy) · procedures are restructured into user-centric, numbered task flows from discovery and onboarding through implementation, adoption, and prevention · Snyk-defined nouns (Tenant, Group, Organization, Project) and UI elements (Settings, Integrations, All integrations, Projects) adhere to Snyk writing rules · [ACTION REQUIRED: ...] markers correctly isolate unresolved single-Group and Team-plan interface behaviors for review before merge.
The current head commit 8d669f9 is reviewed.
Sent by Cursor Automation: PR review for User Docs
Removed outdated information regarding the classic path for integrations.
Removed unnecessary action requirement note regarding Team plan verification in the Snyk documentation.
Removed redundant instruction about confirming the new-navigation location for purchasing a Team plan.


Summary
Moves the Discover Snyk pilot guide and both implementation guides from classic-navigation instructions to the new navigation, and retires the classic banner on those pages.
nav_context: new. Each procedure now starts from the scope selector, then a Settings path (for example, Settings > Security and access > Members).agnosticwith the banner removed: they describe the IDE, provision.snyk.io, or concepts, not app.snyk.io navigation (auto-provisioning-guide,local-scanning-with-the-ide,fix-a-vulnerability,name-your-organization).SUMMARY.md).How the paths were verified
Doc Detective runs against app.snyk.io (new navigation on) in two Enterprise Tenants on October 2, 2026, plus the screenshot set from PR #1815. No Team plan account was checked.
Open questions: resolve before Ready
Six
[ACTION REQUIRED]markers mark locations that could not be verified:navigate-the-snyk-web-ui.md)navigate-the-snyk-web-ui.md)connect-your-development-tools.md)validate-your-snyk-plan.md)phase-2-configure-your-organization/README.md)phase-2-configure-your-organization/README.md)Not in this PR: screenshots
Image references are unchanged. Two of them are already replaced by #1815. Separately, the 21
lh7-rt.googleusercontent.comimages on these pages return 403 to anyone not signed in to the Snyk Google Workspace, so customers most likely see broken images today. They need the originals exported or the screens recaptured in a follow-up.Test plan
discover-snyk[ACTION REQUIRED]markers🤖 Generated with Claude Code
Note
Low Risk
Documentation-only updates to navigation paths and front matter; no application or security logic changes.
Overview
Aligns Discover Snyk pilot, team, and enterprise implementation docs with the new Snyk Web UI navigation and drops the classic “new navigation” banner on those pages.
Most affected pages are retagged
nav_context: newand rewrite click-paths to start from the scope selector, then Settings subtrees (for example Settings > Integrations > All integrations, Security and access > Members / SSO, Products and features for Code/IaC). Flows that are IDE-, provisioning-, or concept-only staynav_context: agnosticwith the banner removed.Pilot SCM guides (GitHub, GitLab, Azure DevOps, Bitbucket) get numbered steps, corrected product names (Bitbucket spelling in
SUMMARY.md), and fixes for wrong “GitHub” copy on GitLab/Azure/Bitbucket pages and “Generate a GitHub PAT” on GitLab. Import repositories, invite members, PR checks, scan coverage, and Snyk Essentials follow the same navigation pattern (e.g. Projects > Add projects instead of Dashboard Import projects).Enterprise and team guides update the same paths for SSO, policies, org creation/cloning, imports, notifications, container/IaC toggles, and broker verification.
navigate-the-snyk-web-ui.mddescribes the scope selector as three segments (All Organizations at Group scope), refreshes Group/Org Settings lists, and narrows Inventory to container images (SBOM removed from the description).Image URLs are unchanged; behavior and screenshots are not part of this diff.
Reviewed by Cursor Bugbot for commit 3ad41b1. Bugbot is set up for automated code reviews on this repo. Configure here.