Skip to content

feat: readability improvements to OSV record#2

Merged
vsutedjo merged 2 commits intogoogle:mainfrom
andrewpollock:readability-improvements
Mar 20, 2025
Merged

feat: readability improvements to OSV record#2
vsutedjo merged 2 commits intogoogle:mainfrom
andrewpollock:readability-improvements

Conversation

@andrewpollock
Copy link
Contributor

This improves the generation of the OSV record:

  • the summary is human readable
  • the policy link is included in the details
  • the details are split over multiple lines

So that the record views more nicely at OSV.dev
and output from the likes of OSV-Scanner
(which may only include the summary) is more
user-friendly.

Per https://ossf.github.io/osv-schema/#summary-details-fields

  • the summary is plain text
  • details is CommonMark markdown

This improves the generation of the OSV record:

- the summary is human readable
- the policy link is included in the details
- the details are split over multiple lines

So that the record views more nicely at OSV.dev
and output from the likes of OSV-Scanner
(which may only include the summary) is more
user-friendly.

Per https://ossf.github.io/osv-schema/#summary-details-fields
- the summary is plain text
- details is CommonMark markdown
Upon reviewing the README.md and the broader
intent of this code, I can see the utility of
retaining this as an explicit field and value
(for self-documenting), even if it is not
currently used.
@vsutedjo vsutedjo merged commit 9acc71a into google:main Mar 20, 2025
2 checks passed
"policy_link": "https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/security/updates.md",
"description": "Dependency on outdated V8 found. Please update to the latest [beta](https://chromium.googlesource.com/v8/v8.git/+/refs/heads/beta), [stable](https://chromium.googlesource.com/v8/v8.git/+/refs/heads/stable), or [extended stable](https://chromium.googlesource.com/v8/v8.git/+/refs/heads/extended) versions."
"summary": "Outdated dependency on V8 found (see details)",
"description": "Outdated dependency on V8 found (see [policy](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/security/updates.md).\n\nPlease update to the latest [beta](https://chromium.googlesource.com/v8/v8.git/+/refs/heads/beta), [stable](https://chromium.googlesource.com/v8/v8.git/+/refs/heads/stable), or [extended stable](https://chromium.googlesource.com/v8/v8.git/+/refs/heads/extended) versions."

Choose a reason for hiding this comment

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

nit: this is missing a ) after the "policy" here.

noticed this on http://test.osv.dev/V8-FRESHNESS

Copy link
Contributor Author

Choose a reason for hiding this comment

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

🤦‍♂️

andrewpollock added a commit to andrewpollock/chromium-policy-vulnfeed that referenced this pull request Mar 21, 2025
This is a post-merge cosmetic fix to google#2
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