Fix the old blurb about versioning since it confuses some people.

Reflect what's already been in place for more than a year now regarding
versioning and API stability
This commit is contained in:
Vincent Hanquez 2017-09-18 10:29:09 +01:00
parent 06dc3de5c4
commit c8569d871a

View File

@ -16,13 +16,23 @@ Instead, rely on higher level protocols or implementations.
Documentation: [cryptonite on hackage](http://hackage.haskell.org/package/cryptonite) Documentation: [cryptonite on hackage](http://hackage.haskell.org/package/cryptonite)
Stability
---------
Cryptonite APIs are stable, and we only strive to add, not change or remove.
Note that because the API exposed is wide and also expose internals things (for
power users and flexibility), certains APIs can be revised in extreme cases
where we can't just add.
Versioning Versioning
---------- ----------
Development versions are an incremental number prefixed by 0. There is no Next version of `0.x` is `0.(x+1)`. There's no exceptions, or API related meaning
API stability between development versions. behind the numbers.
Production versions : TBD Each versions of stackage (going back 3 stable LTS) has a cryptonite version
that we maintain with security fixes when necessary and are versioned with the
following `0.x.y` scheme.
Coding Style Coding Style
------------ ------------