.

obs-staging-bot/README.md

@@ -0,0 +1,18 @@
+OBS Staging Bot
+===============
+
+Build a PR against a ProjectGit, if review is requested.
+
+
+Areas of Responsibility
+-----------------------
+
+* Monitors Notification API in Gitea for review requests
+* Reviews Package build results in OBS for all changed packages in ProjectGit PR
+
+
+Target Usage
+------------
+
+Any project (devel, etc) that accepts PR and wants build results
+

pr-review/README.md

@@ -0,0 +1,20 @@
+PR Review bot
+=============
+
+Keeps ProjectGit PR in-sync with a PackageGit PR
+
+
+Areas of Responsibility
+-----------------------
+
+* Detects a PackageGit PR creation against a package and creates a coresponsing PR against the ProjectGit
+* When a PackageGit PR is updated, the corresponding PR against the ProjectGit is updated
+* Stores reference to the PackageGit PR in the headers of the ProjectGit PR, for later reference
+   * this allows ProjectGit PR to be merged to seperated later (via another tool, for example)
+
+
+Target Usage
+------------
+
+Any project (devel, etc) that accepts PR
+

prjgit-updater/README.md

@@ -0,0 +1,23 @@
+Project Git bot
+===============
+
+Areas of responsibility
+-----------------------
+
+1. Keep ProjectGit in sync with packages in the organization
+   * on pushes to package, updates the submodule commit id
+     to the default branch HEAD (as configured in Gitea)
+   * on package adds, creates a new submodule
+   * on package removal, removes the submodule
+
+2. Assumes:
+   * _ObsPrj = project git
+   * Other repositories == packages (similar to OBS project)
+
+
+Target Usage
+------------
+
+Devel project, where direct pushes to package git are possible
+
+