README: Add notes on integration
Signed-off-by: Jeremy Kerr <jk@ozlabs.org>
diff --git a/README.md b/README.md
index de90a04..62f9195 100644
--- a/README.md
+++ b/README.md
@@ -31,6 +31,27 @@
for the serial binding, the `mctp_serial_read()` function should be invoked
when the file-descriptor for the serial device has data available.
+Integration
+-----------
+
+The libmctp code is intended to be integrated into other codebases by two
+methods:
+
+ 1. as a simple library (`libmctp.a`), which can be compiled separately
+ and linked into the containing project
+
+ 2. as a set of sources to be included into the containing project (either
+ imported, or as a git subtree/submodule)
+
+For (1), you can use the top-level makefile to produce `libmtcp.a`.
+
+For (2), the `Makefile.inc` file provides the minimum set of dependencies to
+either build libmctp.a, or just the actual object files (`LIBMCTP_OBS`), which
+you can include into your existing make definitions. You'll want to set
+`LIBMTCP_DIR` to refer to the subdirectory that contains that makefile, so we
+can set the correct paths to sources.
+
+
Environment configuration
-------------------------