X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=README.md;h=f95defa55b2f9a8361d2d2d1a922169f5ac2498a;hb=HEAD;hp=30149ab4b72d6f6142de810c783105a0e3454ebe;hpb=d364661521d53cac21891bef4f406574d6332f15;p=bcachefs-tools-debian

diff --git a/README.md b/README.md
index 30149ab..f95defa 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,16 @@ This repo primarily consists of the following:
 Please refer to the main site for [getting started](https://bcachefs.org/#Getting_started)
 An in-depth user manual is (also) found on the [official website](https://bcachefs.org/#Documentation)
 
+Version semantics
+-----------------
+
+The tools relies on an expected disk format structure which is reflected by your current kernel version.
+Disk format can be upgraded or downgraded automatically by the kernel, if needed.
+
+- Any patch-level change means no disk format change
+- Any minor-level change means a potential disk format change which **is not breaking**
+- Any major-level change means **breaking changes**
+
 Build and install
 -----------------