diff --git a/.gitmodules b/.gitmodules
index 5b1abec..4f34972 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -19,3 +19,7 @@
 [submodule "pkgs/c/cockpit-tukit"]
 	path = pkgs/c/cockpit-tukit
 	url = https://src.opensuse.org/pool/cockpit-tukit
+[submodule "pkgs/c/chromium"]
+	path = pkgs/c/chromium
+	url = ../../pool/chromium
+	branch = factory
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1b2640d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,75 @@
+# The openSUSE Factory project
+
+This project is managing the entire Factory, aka Tumbleweed distribution.
+
+It defines the used package sources and additional configuration settings
+to build the binaries.
+
+## Package Sources
+
+All package sources are organized below the pkgs directory. These are
+grouped again in subdirectories to avoid too large directory listings.
+
+The `_manifest` file needs to get adapted in case a new subdirectory
+gets created or an existing one gets renamed.
+
+Each package source is defined via a git submodule. The submodules 
+defines
+ * the origin url of the source (in .gitmodules)
+ * the branch to follow (in .gitmodules)
+ * the current used commit hash
+
+Any submodule reference should be relative to allow a full replication
+on other git servers.
+
+### Add a new package source
+
+ ```shell
+   git submodule add -b factory ../../pool/$PACKAGE pkg/$DIRECTORY/$PACKAGE
+   git commit
+ ```
+
+### Remove a package source
+
+ ```shell
+   git rm pkg/$DIRECTORY/$PACKAGE
+   git commit -a
+ ```
+
+This modifies also the .gitmodules file
+
+### Update a package source
+
+This is usually done via our bot infrastucture. But in case a manual action
+is needed run
+
+ ```shell
+   git submodule update --init pkg/$DIRECTORY/$PACKAGE
+   cd pkg/$DIRECTORY/$PACKAGE
+   git pull # or checkout a specific commit/branch
+   cd -
+   git add pkg/$DIRECTORY/$PACKAGE
+   git commit
+ ```
+
+## Additional files
+
+### `_manifest`
+
+Is the master git configuration file. Currently it is only used to define
+the package source structure of the project.
+
+### `_config`
+
+The build configuration (aka prjconf).
+
+### `workflow.config`
+
+Rules for the workflow-pr bot. The bot creates for any pull request against
+any used pool/$PACKAGE git repository factory branch also a pull request for
+this git project here.
+
+### `staging.config`
+
+Defines test builds for any pull request to this project
+
diff --git a/_maintainership.json b/_maintainership.json
index e8f70fc..5d6d8a8 100644
--- a/_maintainership.json
+++ b/_maintainership.json
@@ -1,5 +1,6 @@
 {
   "": ["adamm_super", "dimstar_suse"],
+  "chromium": ["oertel", "gmbr3", "AndreasStieger"],
   "cockpit": ["abrooks", "adamm", "jzerebecki", "malikirri"],
   "cockpit-machines": ["abrooks", "adamm", "jzerebecki", "malikirri"],
   "cockpit-packages": ["abrooks", "adamm", "jzerebecki", "malikirri"],
diff --git a/_manifest b/_manifest
new file mode 100644
index 0000000..a90014a
--- /dev/null
+++ b/_manifest
@@ -0,0 +1,5 @@
+
+# sub directories which provide package sources
+subdirectories:
+ - pkgs/c
+
diff --git a/_subdirs b/_subdirs
deleted file mode 100644
index 47785bd..0000000
--- a/_subdirs
+++ /dev/null
@@ -1,2 +0,0 @@
-subdirs:
-- pkgs/c 
diff --git a/pkgs/c/chromium b/pkgs/c/chromium
new file mode 160000
index 0000000..e557e90
--- /dev/null
+++ b/pkgs/c/chromium
@@ -0,0 +1 @@
+Subproject commit e557e90812e01ebf657107ff8f1ed8db7548aaf3b9a7af48706899d5db898080
diff --git a/staging.config b/staging.config
index 0de70bd..7538fcf 100644
--- a/staging.config
+++ b/staging.config
@@ -1,4 +1,4 @@
 {
    // Reference build project
-   "ObsProject": "openSUSE:Factory",
+   "ObsProject": "openSUSE:Factory:PullRequest",
 }