Skip to content

docs: migrate OSS asset-modelling pages to v3 Asset/Organization terminology + refresh screenshots#15113

Merged
Maffooch merged 1 commit into
DefectDojo:devfrom
stevewallone:docs/screenshot-refresh
Jul 1, 2026
Merged

docs: migrate OSS asset-modelling pages to v3 Asset/Organization terminology + refresh screenshots#15113
Maffooch merged 1 commit into
DefectDojo:devfrom
stevewallone:docs/screenshot-refresh

Conversation

@stevewallone

Copy link
Copy Markdown

Description

Refreshes the open-source Asset Modelling documentation so it matches the current v3 UI:

  • Migrates the OSS asset-modelling pages from the legacy Product / Product Type nomenclature to the v3 Asset / Organization model (slugs product_*OS__asset_* / OS__organizations). Existing URLs are preserved via page aliases, so no inbound links break.
  • Refreshes the screenshots on these pages to the current 3.0 UI — the previous shots still showed the old Product / Product Type terminology.
  • Adds an Asset Health Grade screenshot showing where the A–F grade appears in the Asset List.

Scope is documentation only — 48 files, all under docs/. No code, migration, or .github/ changes.

Test results

Not applicable (documentation only). Pages were built and reviewed locally with hugo server; screenshots, captions, and the aliases redirects all render correctly.

Documentation

This PR is the documentation change.

Checklist

  • Rebased against the very latest dev.
  • Submitted against dev.
  • Meaningful PR name (suitable for release notes).
  • Ruff compliant — n/a, no Python changes.
  • Python 3.13 compliant — n/a, no Python changes.
  • New-feature docs — n/a, this is itself a docs-only PR.
  • DB migrations — n/a, no model changes.
  • Unit tests — n/a, no code changes.
  • Label — suggesting maintenance.

…inology + refresh screenshots

Update the open-source asset-modelling documentation for DefectDojo 3.0's
renamed object model (Product Type -> Organization, Product -> Asset) and
refresh the accompanying screenshots against the 3.0 UI.

- Organizations: rename OS_producttype.md -> OS__organizations.md with
  Organizations content (Organizations vs Assets guidance, boundaries, RBAC)
- Asset Hierarchy & Source Code Repositories: Asset nomenclature + image
  renames (product-* -> asset-*)
- Tagging Objects: reshoot all 7 screenshots and migrate prose
  (Product Type -> Organizations, Product -> Asset, Tags (Product) -> Tags (Asset))
- Asset Health Grade: add a screenshot showing grades in the Asset List
- Image set: add organization_ss1.png and asset-health-grade.png,
  drop PT_ss2.png, refresh Asset_Hierarchy_Overview, dashboard, asset_ss3/ss5

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@stevewallone stevewallone force-pushed the docs/screenshot-refresh branch from 0c39e7b to fad6c3c Compare June 30, 2026 13:25
@Maffooch Maffooch requested a review from paulOsinski June 30, 2026 16:47

@paulOsinski paulOsinski 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.

Thank you for this @stevewallone ! Looks good to me.

@Maffooch Maffooch requested review from Jino-T and blakeaowens June 30, 2026 18:39
@Maffooch Maffooch added this to the 3.1.0 milestone Jun 30, 2026

@mtesauro mtesauro 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.

Approved

@Maffooch Maffooch merged commit 5e4c8d8 into DefectDojo:dev Jul 1, 2026
274 of 276 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants