README: what rand is / is not #1065
Conversation
Fixes rust-random#1049. `nightly` feature is already tested separately.
|
I think adding the helper functions can cover 80% of current uses of
I think we can mention that API is relatively stable, but future breaking releases are possible (e.g. after const generics stabilization). Also that we strictly follow the policy which considers MSRV bumps a breaking change. |
|
To me, "simple" means "the code is easy to understand". Additional API doesn't change that. Maybe this isn't clear? I'm still not convinced the helper functions would be useful. (Maybe the three of us should vote on it, in which case my vote is no so @vks gets the deciding vote.) |
README.md
Outdated
| and [oorandom](https://crates.io/crates/oorandom). | ||
| - Slow. We take performance seriously, with considerations also for set-up | ||
| time of new distributions, commonly-used parameters, and parameters of the | ||
| current sampler |
There was a problem hiding this comment.
There's a . missing at the end.
There is "simple to understand" and "simple to use". Additional API may help with the latter. Maybe there is a better word than simple? |
|
Maybe "simple code"? |
|
Alternatively "simple implementation" could work. "Minimal" might be an option too. |
|
Updated. Versions section revised. |
@vks @newpavlov in light of #989 and several other critiques of this crate, I think perhaps we should clarify what Rand is / is not (because we can't satisfy everyone). This should appear on the crates page when next published, so it should be succinct but not too brief. Thoughts?
Should we mention "Stable" since we're not at 1.0 yet? To me there's little point, but some people may care.