diff --git a/README.org b/README.org
index ce744286..760570ab 100644
--- a/README.org
+++ b/README.org
@@ -106,6 +106,13 @@ there only for convenience, for the following reasons:
 
 3. =make= is shorter to type than =jbuilder build @install=
 
+*** How to add a configure step to a jbuilder project?
+
+[[example/sample-projects/with-configure-step]] shows one way to do it
+that preserve composability; i.e. it doesn't require to manually run
+all =./configure= script when working on multiple projects at the same
+time.
+
 ** Implementation details
 
 This section is for people who want to work on Jbuilder itself.