summaryrefslogtreecommitdiff
path: root/docs/promises.rst
blob: 92ab5aaf9d897da959ebe5bc2f164d67bc08b2cc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
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.