Skip to content

docs: explain CVE record state transitions and unrejection - #2084

Open
JonathanLEvans wants to merge 1 commit into
CVEProject:devfrom
JonathanLEvans:docs/cve-record-state-transitions
Open

JonathanLEvans wants to merge 1 commit into
CVEProject:devfrom
JonathanLEvans:docs/cve-record-state-transitions

Conversation

@JonathanLEvans

Copy link
Copy Markdown

Summary

Add a human-friendly guide to publishing, rejecting, and unrejecting CVE records, including:

  • A table matching common curator actions to API endpoints.
  • The distinction between CVE ID objects and submitted CVE records.
  • Ownership and role requirements, complete-container replacement semantics, and request examples.
  • Rejection and unrejection effects on dates, CNA content, and ADP containers.
  • The limited ID-only return-to-RESERVED case and post-update consistency checks.

Behavior was checked against the controllers, route authorization, model helpers, request validation, and OpenAPI specification at eff17ea. The guide links to the relevant implementation and notes that source behavior does not establish the version deployed in production.

Validation

  • Parsed both JSON request examples.
  • Checked the Bash example with bash -n.
  • Checked Markdown reference definitions and whitespace.
  • Verified the committed document matches the reviewed local file and the branch changes only this document.
  • No live CVE changes or service integration tests were performed (documentation-only change).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 520886a2-4bad-47ed-a0ac-d0783e0d1177

@todb todb left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

LGTM!

This branch has not been deployed

No deployments
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.

2 participants