diff options
authorElena ``of Valhalla'' Grandi <valhalla@trueelena.org>2017-04-15 09:08:53 +0200
committerElena ``of Valhalla'' Grandi <valhalla@trueelena.org>2017-04-15 11:27:56 +0200
commitf6efcd152635aa6655538c7fa316cfc80b6701e9 (patch)
parent4d0fbfdd140e4c226d51a9f941d26cb44001c78e (diff)
Code stability promises
1 files changed, 35 insertions, 0 deletions
diff --git a/docs/promises.rst b/docs/promises.rst
new file mode 100644
index 0000000..92ab5aa
--- /dev/null
+++ b/docs/promises.rst
@@ -0,0 +1,35 @@
+Semantic versioning
+This project uses semver_.
+.. _semver: http://semver.org/
+Collection format stability
+Future versions of lesana will be able to read collections written by
+older versions.
+Older versions in the same mayor release will also be able to work
+concurrently on the same repository.
+If in the future a change of formats will be required, conversions
+scripts will be written in a way that will make them as stable as
+possibile, and will have enought test data to keep them maintained for
+the time being.
+Disposable cache
+Contrary to the yaml files, the xapian cache is considered disposable:
+from time to time there may be a need to delete the cache and reindex
+everything, either because of an upgrade or to perform repository
+Of course, effort will be made to reduce the need for this so that it
+only happens sporadically, but it will probably never completely