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 @@
+Promises
+========
+
+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
+mainteinance.
+
+Of course, effort will be made to reduce the need for this so that it
+only happens sporadically, but it will probably never completely
+disappear.