diff --git a/manifests/README.md b/manifests/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..060c9b61e246f04773fbd189abf04e0c95959f22
--- /dev/null
+++ b/manifests/README.md
@@ -0,0 +1,12 @@
+# SPDX-FileCopyrightText: Huawei Inc.
+#
+# SPDX-License-Identifier: Apache-2.0
+
+# `repo` manifests
+
+Setting up a `oniro` workspace is done using the `repo` tool which in turn uses
+the included manifest files for project definitions. These define and set
+upstream components (for example
+[oe-core](https://git.openembedded.org/openembedded-core/)). For detailed
+information on how to setup a `repo` workspace, checkout the
+[documentation](https://docs.oniroproject.org/).