Skip to content

Commit e5134e8

Browse files
committed
doc: add policy on new PRNG algorithms
1 parent 3f191be commit e5134e8

File tree

1 file changed

+20
-1
lines changed

1 file changed

+20
-1
lines changed

doc/README.md

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,4 +61,23 @@ and wherever possible within the same function (thus making the function safe).
6161

6262
### New PRNG Algorithms
6363

64-
TODO
64+
The Rand library includes several pseudo-random number generators, and we have
65+
received several requests to adopt new algorithms into the library. We must
66+
consider such requests in regards to several things:
67+
68+
- whether the PRNG is cryptographically secure, and if so, how trustworthy
69+
such claims are
70+
- statistical quality of output
71+
- performance and features of the generator
72+
- scope of the project
73+
- reception and third-party review of the algorithm
74+
75+
In general, we expect:
76+
77+
- the author of the algorithm to publish an article of some type (e.g.
78+
a scientific article or web page) introducing the new algorithm and
79+
discussing its utility, strengths and weaknesses
80+
- review of statistical quality and any special features by third parties
81+
- good performance in automated test suites like PractRand, TestU01 and
82+
BigCrush, (unless for some reason this is not expected, e.g. a mock
83+
generator)

0 commit comments

Comments
 (0)