docs/composefs: Add note about toplevel dirs

Just thinking about trying to land this, I think some people
may hit this one.

diff --git a/docs/composefs.md b/docs/composefs.md
index ebc26af3cbb6bc21c7fdc8ce99bdf48413ef61b9..b95c61f6b429aee329bef4040b9f50a7520b9063 100644 (file)
--- a/docs/composefs.md
+++ b/docs/composefs.md
@@ -87,6 +87,19 @@ At the current time, there are no additional userspace runtime requirements.
 **IMPORTANT** The integration with composefs is experimental and subject to change.  Please
 try it and report issues but do not deploy to production systems yet.
 
+## Compatiblity
+
+One issue that ostree users transitioning to composefs may hit is that it is no
+longer possible to add new toplevel directories via the `chattr -i / && mkdir /somedir && chattr -i`
+trick.   A bit more on this in the following issues:
+
+* <https://github.com/coreos/rpm-ostree/issues/337>
+* <https://github.com/ostreedev/ostree/pull/2681>
+
+However, users who were doing things like this probably want to enable the
+`root.transient` option; see `man ostree-prepare-root` which will allow
+this (but also change other behaviors too).
+
 ## Comparison with other approaches
 
 There is also support for using [IMA](ima.md) with ostree.  In short, composefs