diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..44c5269
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,15 @@
+==========
+manifest
+==========
+
+StarlingX Manifest
+
+Developer Notes
+---------------
+When updating xml files in this repo please remember to update the appropriate
+.gitignore file in https://opendev.org/starlingx/root otherwise the
+"repo status" command will show the new repo as an untracked change.
+
+When updating the default.xml manifest, please also remember to update
+the appropriate layer manifest as well.
+