Add README.md file.
Bug: N/A
Test: N/A
Change-Id: If87ef10b815b1336f809a820ec8fa79c8b1a8d7f
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2164259
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# frameworks/libs/modules-utils/
+
+Libraries and utilities intended for use by module and framework code.
+
+Since modules use the code in this project, it must adhere to mainline
+requirements, for example, by setting min_sdk_version in Soong modules.
+
+## Java code
+
+This project uses a single source path for Java code. All Java code should go
+in the `java` directory with subdirectories corresponding to the java package.
+`Android.bp` files should go alongside the java source files, and should only
+include java source for a single java package to encourage good code hygiene.
+
+Tests for java code should go in the `javatests` directory and follow the same
+structure.
