search

tobie / specref

An open-source, community-maintained database of Web standards & related references.
http://www.specref.org/
Apache License 2.0
165 stars 141 forks source link

Update FIPS refs. #741

Closed davidlehn closed 1 year ago

davidlehn commented 1 year ago

I'm not sure what the best practice is for refs like "DSS". It was the full FIPS-186-4 ref and this PR changes it to an alias. It seems that since other docs may refer to specific FIPS publications, that "DSS" should be an alias to the latest FIPS ref and be updated every decade or so as new FIPS publications are released.

Also unsure what best practice is for what the href is. These refs link to the PDF "Local Download" links NIST has, but they also have publication info pages with PDF links and more, and doi URLs for the PDF. For example https://csrc.nist.gov/publications/detail/fips/186/5/final.

tobie commented 1 year ago

I'm not sure what the best practice is for refs like "DSS". It was the full FIPS-186-4 ref and this PR changes it to an alias. It seems that since other docs may refer to specific FIPS publications, that "DSS" should be an alias to the latest FIPS ref and be updated every decade or so as new FIPS publications are released.

That sounds reasonable indeed.

Also unsure what best practice is for what the href is. These refs link to the PDF "Local Download" links NIST has, but they also have publication info pages with PDF links and more, and doi URLs for the PDF. For example https://csrc.nist.gov/publications/detail/fips/186/5/final.

It's hard to say what's best. As there's bi-directional linking anyway, I feel like what you picked is fine.

tobie commented 1 year ago

Thank you for your contribution!

A new version of Specref updated with these changes should auto-deploy within minutes. You can search www.specref.org to check for it.

Don't hesitate to comment back here if you can't find your changes within 10 minutes; it's a sign something is off and I'll immediately look into it. Thanks!