Skip to content

docs: tweak docs site structure; documenting missing analyzers#8462

Merged
jeremylong merged 3 commits intodependency-check:mainfrom
chadlwilson:tidy-site-structure
Apr 29, 2026
Merged

docs: tweak docs site structure; documenting missing analyzers#8462
jeremylong merged 3 commits intodependency-check:mainfrom
chadlwilson:tidy-site-structure

Conversation

@chadlwilson
Copy link
Copy Markdown
Collaborator

Description of Change

This is a minor proposal - should treat suggestions as indicative.

Structure

  • elevates Remote Data Sources to top level to add discovery
    • removes stub OSS Index data source docs; redirects to OSS Index Analyzer docs
  • renames "Modules" to "Components & Integrations"; moving above analyzers
  • renames "File Type Analyzers" just to "Analyzers"
    • Splits these into Regular / Augmented / Experimental and makes menu consistent with page
  • adds missing analyzers to the menu to match the table/index.html

Default view (general + data sources expanded)
image

Remote Data Sources
image

Components & Integrations
image

Analyzers
image

Analyzers Index
image

Missing docs

  • adds basic documentation for Artifactory, Yarn Audit, PNPM Audit analyzers
    • there are still a few missing I am less familiar with, e.g Elixir Mix Audit, libman

Related issues

N/A

Have test cases been added to cover the new functionality?

N/A

@boring-cyborg boring-cyborg Bot added the documentation site documentation label Apr 27, 2026
@chadlwilson chadlwilson requested a review from Copilot April 27, 2026 17:40
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates the Maven site navigation and analyzer documentation to improve docs discoverability and add missing analyzer pages.

Changes:

  • Restructures the left-nav: promotes Remote Data Sources, renames “Modules” to “Components & Integrations”, and reorganizes analyzers into top-level + Augmenting/Experimental groupings.
  • Updates existing docs pages/links to match the new structure (e.g., ISO scan page, OSS Index link, central/nexus docs cross-links).
  • Adds new documentation pages for Artifactory, Yarn Audit, and PNPM Audit analyzers; removes the old OSS Index data-source stub page.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
src/site/site.xml Reworks site menu structure, labels, and analyzer navigation entries.
src/site/markdown/general/scan_iso.md Updates link text to match “Analyzers” naming.
src/site/markdown/data/ossindex.md Removes OSS Index data-source stub page (now points users to analyzer docs elsewhere).
src/site/markdown/data/index.md Fixes a typo and retargets OSS Index link to analyzer documentation.
src/site/markdown/components.md Renames “Modules” page heading to “Components & Integrations”.
src/site/markdown/analyzers/yarn-audit.md Adds Yarn audit analyzer documentation page.
src/site/markdown/analyzers/pnpm-audit.md Adds PNPM audit analyzer documentation page.
src/site/markdown/analyzers/nexus-analyzer.md Improves wording and adds cross-links/updated references.
src/site/markdown/analyzers/index.md Splits analyzers into sections and adds PNPM/Yarn entries.
src/site/markdown/analyzers/central-analyzer.md Adds explicit links to Nexus/Artifactory analyzer docs.
src/site/markdown/analyzers/artifactory-analyzer.md Adds Artifactory analyzer documentation page.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread src/site/site.xml Outdated
Comment thread src/site/markdown/analyzers/pnpm-audit.md Outdated
Comment thread src/site/markdown/analyzers/pnpm-audit.md
Comment thread src/site/markdown/analyzers/yarn-audit.md
Comment thread src/site/markdown/analyzers/artifactory-analyzer.md Outdated
Comment thread src/site/markdown/analyzers/index.md
Comment thread src/site/markdown/analyzers/index.md Outdated
Comment thread src/site/markdown/data/index.md
Also documents the Artifactory Analyzer.

Signed-off-by: Chad Wilson <[email protected]>
@chadlwilson chadlwilson force-pushed the tidy-site-structure branch from 1356464 to 2b67f89 Compare April 27, 2026 17:50
@chadlwilson chadlwilson requested a review from Copilot April 27, 2026 17:50
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 5 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread src/site/markdown/analyzers/index.md
Comment thread src/site/site.xml
Comment thread src/site/markdown/analyzers/pnpm-audit.md
Comment thread src/site/markdown/analyzers/yarn-audit.md
Comment thread src/site/markdown/analyzers/artifactory-analyzer.md
@jeremylong jeremylong added this to the 12.2.2 milestone Apr 29, 2026
Copy link
Copy Markdown
Collaborator

@jeremylong jeremylong left a comment

Choose a reason for hiding this comment

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

lgtm

@jeremylong jeremylong merged commit 2fe33e2 into dependency-check:main Apr 29, 2026
15 checks passed
@chadlwilson chadlwilson deleted the tidy-site-structure branch April 29, 2026 12:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation site documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants