.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

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
+

_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"],

_manifest

@@ -0,0 +1,5 @@
+
+# sub directories which provide package sources
+subdirectories:
+ - pkgs/c
+

_subdirs

@@ -1,2 +0,0 @@
-subdirs:
-- pkgs/c 

staging.config

@@ -1,4 +1,4 @@
 {
    // Reference build project
-   "ObsProject": "openSUSE:Factory",
+   "ObsProject": "openSUSE:Factory:PullRequest",
 }