Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update database prefix documentation to be more detailed #143

Merged
merged 4 commits into from
Apr 18, 2023

Conversation

joshbuker
Copy link
Contributor

@joshbuker joshbuker commented Apr 3, 2023

Rather than a generic description, updated the table to provide more specific (and actionable) information:

  • Prefix
  • Database Name / Source URL
  • Canonical URL for a given <ID>
  • API Endpoint for a given <ID>
  • Regex for the ID

May not be fully complete or accurate, but should provide more actionable guidance for OSV consumers and producers.

@joshbuker joshbuker force-pushed the update/prefix-documentation branch from 7731026 to 03a25b3 Compare April 3, 2023 22:41
@joshbuker
Copy link
Contributor Author

Alternatively, we can embed the same information in the description field using <ul> or similar.

Copy link
Contributor

@oliverchang oliverchang left a comment

Choose a reason for hiding this comment

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

thanks for starting this! some comments/questions here.

docs/schema.md Outdated Show resolved Hide resolved
@joshbuker joshbuker force-pushed the update/prefix-documentation branch from 6a41d11 to ef406d4 Compare April 4, 2023 07:44
@joshbuker
Copy link
Contributor Author

joshbuker commented Apr 4, 2023

That's odd...I amended my commit with the sign-off, and the build is still failing...?

Edit: I missed a commit before my merge commit. It was easiest to just redo my history with a soft reset and sign off on that.

Rather than a generic description, updated the table to provide more specific
(and actionable) information:

- Prefix
- Database Name / Source URL
- Canonical URL for a given <ID>
- API Endpoint for a given <ID>
- Regex for the ID

May not be fully complete or accurate, but should provide more actionable
guidance for OSV consumers and producers.

Signed-off-by: Josh Buker <crypto@joshbuker.com>
@joshbuker joshbuker force-pushed the update/prefix-documentation branch from ef406d4 to 82c67c5 Compare April 4, 2023 07:55
joshbuker added a commit to joshbuker/osv-schema that referenced this pull request Apr 12, 2023
Signed-off-by: Josh Buker <crypto@joshbuker.com>
Copy link
Contributor

@oliverchang oliverchang left a comment

Choose a reason for hiding this comment

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

Thanks! This LGTM. I added two commits filling in some contribution links and OSV URLs though. Let me know if you agree.

@joshbuker
Copy link
Contributor Author

joshbuker commented Apr 13, 2023

@oliverchang Heads up that you missed the sign-off on your commits.

LGTM, I'll add https://gsd.id/getting-started for how to contribute to GSD (docs are WIP) after your commits are fixed, but otherwise don't see any issues.

@oliverchang
Copy link
Contributor

@oliverchang Heads up that you missed the sign-off on your commits.

Yep I messed up there :) Merging !

@oliverchang oliverchang merged commit 1550bfa into ossf:main Apr 18, 2023
@joshbuker joshbuker deleted the update/prefix-documentation branch April 18, 2023 19:30
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