Skip to content

Add pseudo random number generator info to randomUUID - #38074

Merged
Trott merged 1 commit into
nodejs:masterfrom
srknzl:docs-improve-randomUUID
Apr 11, 2021
Merged

Add pseudo random number generator info to randomUUID#38074
Trott merged 1 commit into
nodejs:masterfrom
srknzl:docs-improve-randomUUID

Conversation

@srknzl

@srknzlsrknzl commented Apr 4, 2021

Copy link
Copy Markdown
Contributor

Hello, 😊 !

As far as I understand, recently added function crypto.randomUUID is cryptographically strong. I think it's better to mention it in the docs.

ref: #36729

@nodejs-github-botnodejs-github-bot added crypto Issues and PRs related to the crypto subsystem. doc Issues and PRs related to the documentations. labels Apr 4, 2021
@srknzl

srknzl commented Apr 4, 2021

Copy link
Copy Markdown
ContributorAuthor

alternatively we can say

"The UUID is generated using a cryptographically strong pseudo random number generator."

as in the case of javadoc of randomUUID java method

https://docs.oracle.com/javase/7/docs/api/java/util/UUID.html#randomUUID()

@jasnell

Copy link
Copy Markdown
Member

I'd remove the word "strong" to be honest. While it may be clear to those who are very familiar with pseudo-random number generators, I'd suspect that it's fairly meaningless to most developers. "The UUID is generated using a cryptographic pseudo-random number generator" would be just fine I think.

@srknzlsrknzl changed the title Add "cryptographically strong" to description of randomUUIDAdd pseudo random number generator info to randomUUIDApr 7, 2021
Comment threaddoc/api/crypto.md Outdated
@Trott
Trottforce-pushed the docs-improve-randomUUID branch from 75650f2 to 051743cCompareApril 11, 2021 17:47
PR-URL: nodejs#38074
Refs: nodejs#36729
Reviewed-By: Rich Trott <rtrott@gmail.com>
@Trott
Trottforce-pushed the docs-improve-randomUUID branch from 051743c to 993a1daCompareApril 11, 2021 20:40
@Trott

Copy link
Copy Markdown
Member

Landed in 993a1da

@Trott
Trott merged commit 993a1da into nodejs:masterApr 11, 2021
targos pushed a commit that referenced this pull request May 1, 2021
PR-URL: #38074
Refs: #36729
Reviewed-By: Rich Trott <rtrott@gmail.com>
@danielleadamsdanielleadams mentioned this pull request May 3, 2021
danielleadams pushed a commit that referenced this pull request May 8, 2021
PR-URL: #38074
Refs: #36729
Reviewed-By: Rich Trott <rtrott@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cryptoIssues and PRs related to the crypto subsystem.docIssues and PRs related to the documentations.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants

@srknzl@jasnell@Trott@nodejs-github-bot