Skip to content

docs: remove Snyk 2.0 Early Access hints and fix stale links (DOCT-2626) - #1621

Merged
esabou-snyk merged 2 commits into
mainfrom
docs/doct-2626-remove-snyk-2.0-page
Sep 15, 2026
Merged

esabou-snyk merged 2 commits into
mainfrom
docs/doct-2626-remove-snyk-2.0-page

Conversation

@esabou-snyk

@esabou-snyk esabou-snyk commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Updates link in snyk-release-process.md from the deleted page to navigate-the-snyk-web-ui
  • Removes redundant {% hint style="info" %} "Snyk 2.0 (Early Access)" blocks from 6 pages across scan-fix-and-prevent/ and platform-administration/; all 6 already have nav_context: new frontmatter which renders the reusable banner (added in docs: add new-navigation-banner to scan-fix-and-prevent classic pages (DOCT-2626 Phase B) #1582)
  • The snyk-2.0-platform-improvements.md source file and SUMMARY entry will be removed automatically via Git Sync when CR 28 is merged

Test plan

  • grep -r "Snyk 2.0" . returns only whats-new.md, SUMMARY.md, and snyk-2.0-platform-improvements.md (all auto-managed or deleted via CR 28)
  • grep -r "snyk-2.0-platform-improvements" . returns only whats-new.md and SUMMARY.md
  • Verify the 6 edited pages render the nav_context: new banner correctly in GitBook preview

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only edits with no product, auth, or data-handling impact.

Overview
Documentation cleanup for the rolled-out Snyk Web UI navigation: removes duplicate “Snyk 2.0 (Early Access)” info hints from six pages in platform administration and scan/fix/prevent, since those pages already use nav_context: new for the shared navigation banner.

snyk-release-process.md replaces the broken Early Access features link to deleted “Snyk 2.0 platform improvements” with Navigate the Snyk Web UI.

Minor copy fixes on dependencies-and-licenses/README.md: corrects “Reporting API” link text and Dockerfile filter wording (typos). group-and-organization-settings.md tweaks Notifications/Preview bullets from “See” to “Visit”. manage-asset-inventory/README.md changes “may” to “can” in one sentence.

Reviewed by Cursor Bugbot for commit 30d0913. Bugbot is set up for automated code reviews on this repo. Configure here.

- Update link in snyk-release-process.md to point to navigate-the-snyk-web-ui
- Remove redundant "Snyk 2.0 (Early Access)" hint blocks from 6 pages;
  all have nav_context: new frontmatter which renders the reusable banner

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@esabou-snyk
esabou-snyk requested a review from a team as a code owner August 11, 2026 09:55
@snyk-io

snyk-io Bot commented Aug 11, 2026

Copy link
Copy Markdown

Snyk checks have passed. No issues have been found so far.

Status Scan Engine Critical High Medium Low Total (0)
Open Source Security 0 0 0 0 0 issues
Licenses 0 0 0 0 0 issues
Code Security 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

* Reports
* [Repositories tested in CI/CD report](https://app.gitbook.com/s/BJO0IZx7zB6bOkotxQP2/prevent/analytics/reports-tab/prevention-reports#repositories-tested-in-ci-cd-report)
* [Snyk 2.0 platform improvements](snyk-2.0-platform-improvements.md)
* [Navigate the Snyk Web UI](../navigate-the-snyk-web-ui.md)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Issue: Every other entry in this list names a feature; this one names a docs page.

Fix: * [Snyk 2.0 platform navigation](../navigate-the-snyk-web-ui.md)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

don't apply the name suggested in this fix, it is not aligned with the ticket scope of removing Snyk 2.0 mentions


If you are an existing user, you can switch between the new and classic navigation at any time using the toggle in your user profile menu. For more information, visit [Snyk 2.0 platform improvements](https://app.gitbook.com/s/L7HyJj9FsK1W4pNt8Gzl/snyk-2.0-platform-improvements).
{% endhint %}

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Issue: Two consecutive blank lines left where the hint was.


If you are an existing user, you can switch between the new and classic navigation at any time using the toggle in your user profile menu. For more information, visit [Snyk 2.0 platform improvements](https://app.gitbook.com/s/L7HyJj9FsK1W4pNt8Gzl/snyk-2.0-platform-improvements).
{% endhint %}

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Issue: Two consecutive blank lines left where the hint was.

Snyk 2.0 introduces UI enhancements to the platform navigation and is available in Early Access. This is being rolled out gradually, so not all users see the new navigation at the same time.

If you are an existing user, you can switch between the new and classic navigation at any time using the toggle in your user profile menu. For more information, visit [Snyk 2.0 platform improvements](https://app.gitbook.com/s/L7HyJj9FsK1W4pNt8Gzl/snyk-2.0-platform-improvements).
{% endhint %}

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Issue: Two consecutive blank lines left where the hint was.

@@ -23,15 +23,6 @@ Here is a list of all the available inventory tabs:

Each inventory tab may include different counts of assets and scanned artifacts, depending on the grouping context. Otherwise, all columns and data manipulation features are the same on each inventory layout.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Issue: "may include" — ambiguous modal.

Proposed: "Each inventory tab can include different counts..."

@@ -34,12 +34,3 @@ At the Organization level, select **Settings** to manage Organization settings a
* **Notifications**: See the [Manage notifications](../manage-notifications.md) page for details.
* **Snyk Preview**: See the [Snyk Preview page](../snyk-preview.md) for details.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Issue: File now ends with a stray blank line.

Fix: Trim to a single trailing newline.

Comment on lines 34 to 35
* **Notifications**: See the [Manage notifications](../manage-notifications.md) page for details.
* **Snyk Preview**: See the [Snyk Preview page](../snyk-preview.md) for details.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Issue: "See the ... page" — style is "visit," not "see," when pointing to a page.

Fix: "Visit the Manage notifications page for details." Same for Snyk Preview.

@@ -41,12 +41,3 @@ Users with Group access can view data for the Organizations associated with thos

Snyk restricts access based on Organization-level permissions in both predefined and custom roles.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Issue: File now ends with a stray blank line.

Fix: Trim to a single trailing newline.

@@ -20,12 +20,3 @@ For both dependencies and licenses, you can filter by Project or other filter cr
Results from the Dockerfile Project type are filtered out by default in the filter criteria as they can result in duplication of results from scans of the images resulting from building the Dockerfiles. To match results from [AP](https://app.gitbook.com/s/IEEjSXQQu36y0vmFV8zf/snyk-api/reference/reporting-api-v1)I calls, either filter out Dockerfiles from the API results or turn on Dockfiles in the Project type column of the filter.
{% endhint %}

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Issue: File now ends with a stray blank line.

Fix: Trim to a single trailing newline.

@@ -20,12 +20,3 @@ For both dependencies and licenses, you can filter by Project or other filter cr
Results from the Dockerfile Project type are filtered out by default in the filter criteria as they can result in duplication of results from scans of the images resulting from building the Dockerfiles. To match results from [AP](https://app.gitbook.com/s/IEEjSXQQu36y0vmFV8zf/snyk-api/reference/reporting-api-v1)I calls, either filter out Dockerfiles from the API results or turn on Dockfiles in the Project type column of the filter.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Issue: Link markup splits the word API ([AP](...)I calls), and "Dockfiles" is a typo.

Fix: "To match results from Reporting API calls, either filter out Dockerfiles from the API results or turn on Dockerfiles in the Project type column of the filter."

@cursor cursor Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The current head commit 12eef78 is reviewed.

Open in Web View Automation 

Sent by Cursor Automation: PR review for User Docs

@esabou-snyk

Copy link
Copy Markdown
Contributor Author

Rebased onto main (resolved the file-rename conflict from the manage-assets.mdfix/manage-asset-inventory/README.md move) and addressed the review feedback:

  • Fixed the two "consecutive blank lines" left behind by the hint-block removal (switch-between-groups-and-organizations.md, tenant/README.md)
  • "may include" → "can include" wording (manage-asset-inventory/README.md)
  • Trimmed stray trailing blank lines (group-and-organization-settings.md, analytics/README.md, dependencies-and-licenses/README.md)
  • "See the ... page" → "Visit the ... page" for Notifications/Snyk Preview bullets
  • Fixed the split [AP](...)I link markup and the "Dockfiles" typo → [Reporting API](...) / "Dockerfiles"

Left snyk-release-process.md link text as [Navigate the Snyk Web UI] per Veronica's note — not renaming to "Snyk 2.0 platform navigation" since that's out of scope for this ticket.

Ready for re-review.

…-snyk-2.0-page

# Conflicts:
#	discover-snyk/getting-started/snyk-release-process.md
#	scan-fix-and-prevent/fix/manage-asset-inventory/README.md
#	scan-fix-and-prevent/manage-risk/analytics/README.md
#	scan-fix-and-prevent/manage-risk/dependencies-and-licenses/README.md
@esabou-snyk
esabou-snyk force-pushed the docs/doct-2626-remove-snyk-2.0-page branch from 46a0d10 to 30d0913 Compare September 15, 2026 07:23
@esabou-snyk
esabou-snyk merged commit f72ff61 into main Sep 15, 2026
15 of 17 checks passed
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.

3 participants