aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRobin Krahl <robin.krahl@ireas.org>2020-09-03 17:37:17 +0200
committerDaniel Mueller <deso@posteo.net>2020-09-05 11:36:15 -0700
commit057fb89b3e99f2b9bef5d3055d362c80352a2661 (patch)
tree746b945ca3caff801bb4a13eb99ea3d21807f8b4
parent47fbed75048ab03355f839015664e12757b5540a (diff)
downloadnitrocli-057fb89b3e99f2b9bef5d3055d362c80352a2661.tar.gz
nitrocli-057fb89b3e99f2b9bef5d3055d362c80352a2661.tar.bz2
Declare semver compatibility and public API
This patch adds a new section to the README that declares that we follow the Semantic Versioning specification and that the public API of our crate is defined by the man page.
-rw-r--r--CHANGELOG.md1
-rw-r--r--README.md8
2 files changed, 9 insertions, 0 deletions
diff --git a/CHANGELOG.md b/CHANGELOG.md
index aeff1be..f5b6c93 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -20,6 +20,7 @@ Unreleased
set the defaults for the `--model` and `--verbose` options
- Changed the handling of the `NITROCLI_NO_CACHE` variable to check
the value of the variable instead of only the presence
+- Declared public API to be the man page
- Adjusted license & copyright headers to comply with REUSE 3.0
- Added CI stage checking compliance
- Updated minimum required Rust version to `1.42.0`
diff --git a/README.md b/README.md
index f1b4656..e6500f0 100644
--- a/README.md
+++ b/README.md
@@ -141,6 +141,13 @@ Known Problems
running shortly afterwards ([upstream issue][libnitrokey#137]).
+Public API and Stability
+------------------------
+
+**nitrocli** follows the [Semantic Versioning specification 2.0.0][semver].
+Its public API is defined by the [nitrocli(1) `man` page](doc/nitrocli.1.pdf).
+
+
Contributing
------------
@@ -182,3 +189,4 @@ the full text of the license.
[libnitrokey#32]: https://github.com/Nitrokey/libnitrokey/issues/32
[libnitrokey#137]: https://github.com/Nitrokey/libnitrokey/issues/137
[reuse]: https://reuse.software/practices/3.0/
+[semver]: https://semver.org