Skip to content

docs: publish the four docs changes stranded on dev - #15649

Merged
devGregA merged 4 commits into
bugfixfrom
docs/publish-backlog-bugfix
Aug 12, 2026
Merged

docs: publish the four docs changes stranded on dev#15649
devGregA merged 4 commits into
bugfixfrom
docs/publish-backlog-bugfix

Conversation

@devGregA

Copy link
Copy Markdown
Contributor

Four documentation changes were merged into dev and are therefore not on the live docs site. gh-pages.yml builds docs.defectdojo.com only on pushes to master and bugfix, so anything merged to dev stays unpublished until the next minor. This brings them to bugfix so they publish on the next patch.

Cherry-picked in their original dev order, -x so each commit records its source:

Commit Origin
e97be18ab0 #15584 — Exporting SBOMs and VEX (Pro)
8c418687ab #15619 — organization types + non-exclusive membership
71807ded61 #15629 — asset versions, BOM snapshots, per-version SBOM/VEX export
a32ac15629 #15633 — asset kinds and per-source asset aliases

All four applied without conflict, and the five resulting files are byte-identical to their current state on dev. No content was rewritten in the move.

The order matters: #15629 edits the SBOM pages that #15584 created, and #15633 edits the asset pages ahead of further work. Cherry-picking any one of them alone conflicts, which is why they travel together.

Docs only. No code changes.

devGregA and others added 4 commits August 12, 2026 16:17
Documents the new Pro export endpoints: an Asset's dependency inventory as
CycloneDX 1.6 / SPDX 2.3, and finding statuses as a CycloneDX VEX document,
including the status-to-analysis mapping and current-inventory boundaries.
Cross-linked from the Working with SBOMs page.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
(cherry picked from commit e97be18)
* docs: organization types + non-exclusive membership

Documents the Pro organization additions that ship with the non-exclusive
membership work:

- Organization Types: the org_type facet (team / business application /
  compliance scope / portfolio / custom), orthogonal-axes framing, and
  same-type nesting via parent_organization (reporting/navigation only --
  nesting does not grant access).
- Non-Exclusive Membership: the DD_V3_ORGANIZATION_NONEXCLUSIVE deployment
  flag (off by default), the primary membership as the access/billing
  anchor, additional memberships with provenance (user pin / connector /
  rule), access following every membership (why pinning requires edit on
  both sides), the new Member Assets table and asset-side Organizations
  tab, and the /api/v2/organization_memberships/ + org_type /
  parent_organization API surfaces.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* docs: the organization asset list and org filters cover every member asset

* docs: asset membership surface is a panel, not a tab

---------

Co-authored-by: devGregA <greg-agent-2@defectdojo.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
(cherry picked from commit 8c41868)
…15629)

Documents the Pro asset-version additions:

- Asset Versions and BOM Snapshots: the DD_V3_ASSET_VERSIONS deployment
  flag (off by default), why a version is metadata about an Asset rather
  than another Asset, binding an upload via `version` (falling back to the
  document's own subject version), the absence of version ordering, and
  snapshots superseding per (version, format) while history stays
  queryable -- a separate axis from replace_dependencies.
- found_in / fixed_in claims stamped from scan imports that carry a
  version, additive and never automatically withdrawn.
- Per-version SBOM export via `?version=`: components from that version's
  snapshot, `dependencies` reproducing the declared graph rather than a
  flat fan, the version on metadata.component / SPDX versionInfo, and the
  404-on-unknown-version behavior.
- Per-version VEX: fixed_in reports resolved at that version while the
  same Finding stays exploitable where it was found; no cross-version
  inference, and a global mitigation is not a per-version fix claim.
- The /api/v2/asset_versions/ and /api/v2/finding_version_affects/
  surfaces, including why neither offers an update action.

Also corrects the SBOM upload field name on the same page: the API field
is `replace_dependencies`, not `replace`, so a request sending `replace`
was silently importing cumulatively.

Co-authored-by: devGregA <greg-agent-2@defectdojo.com>
Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
(cherry picked from commit 71807de)
…15633)

Documents the two user-visible halves of the identity work:

* Asset Kinds -- an optional, descriptive kind per Asset (repository, service,
  host, ...), drawn from an editable registry rather than a fixed list.
* Asset Identity -- per-source aliases (namespace / type / value), what makes an
  identifier resolve to exactly one Asset, why user-asserted aliases survive
  automation, and why there is no update action.

Also documents how connector Auto-Mapping now chooses a Product: the tool's own
identifier first, the name second, a new Product last -- and that turning the
feature on changes nothing about mappings that already exist.

Co-authored-by: devGregA <greg-agent-3@defectdojo.com>
(cherry picked from commit a32ac15)
@devGregA
devGregA added this pull request to the merge queue Aug 12, 2026
Merged via the queue into bugfix with commit a070332 Aug 12, 2026
48 checks passed
@devGregA
devGregA deleted the docs/publish-backlog-bugfix branch August 12, 2026 23:04
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.

3 participants