diff --git a/README.md b/README.md
index a4e3f82..d414a5e 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,13 @@
-Pungi configurations. Always in flux.
+pungi-rocky
+===========
+
+This repo contains various confs and XML data to necesitate the compose
+process. For the most part, the configurations stay static. Extra repos
+will receive their own confs that list their specific compose tag in
+koji.
+
+The `upcoming` folder is for upcoming point releases, which are more
+in flux than those in the root folder. When a point release drops, the
+configs will then be brought down into the root folder to prepare for
+updates and new composes.
+
diff --git a/upcoming/README.md b/upcoming/README.md
new file mode 100644
index 0000000..ccaa415
--- /dev/null
+++ b/upcoming/README.md
@@ -0,0 +1,4 @@
+upcoming
+========
+
+Only for upcoming releases. Configurations will be moved to the root when ready.