From 63e8f3fb090a583226c7435bd900e10d41a30b89 Mon Sep 17 00:00:00 2001
From: Eric Rakestraw <eric@rakestraw.us>
Date: Thu, 17 Sep 2026 19:20:11 +0000
Subject: [PATCH] Prepare the D&D collection for its first release

---
 README.md        | 30 ++++++++++++++++++++++--------
 requirements.yml | 10 +++++-----
 2 files changed, 27 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index 75857ad..963ffc0 100644
--- a/README.md
+++ b/README.md
@@ -4,16 +4,34 @@ An Ansible collection for installing and configuring the D&D
 transcript-processing pipeline on Ubuntu 26.04. The assembled pipeline role is
 available as `rakestraw.dnd.pipeline` and supports Ansible Core 2.18 or newer.
 
-## Install from source
+Release `0.1.0` contains the reviewed `rakestraw.dnd_pipeline` `v0.1.0`
+snapshot and pins the Seriatim, Audita, Notarius, Scriptorium, and Narratio
+roles to their respective `v0.1.0` releases.
 
-Bootstrap the collection's exact standalone-role and collection dependencies:
+## Install release 0.1.0
+
+Download the tagged compatibility manifest and install its exact standalone
+role and collection dependencies:
 
 ```sh
+curl -fLO \
+  https://gitea.maximumdirect.net/eric/ansible-collection-dnd/raw/tag/v0.1.0/requirements.yml
 ansible-galaxy install -r requirements.yml
 ```
 
-Build the collection into a temporary directory, then install the artifact
-without resolving dependencies a second time:
+Then install the published collection artifact without resolving dependencies
+a second time:
+
+```sh
+ansible-galaxy collection install \
+  https://gitea.maximumdirect.net/eric/ansible-collection-dnd/releases/download/v0.1.0/rakestraw-dnd-0.1.0.tar.gz \
+  --no-deps
+```
+
+## Build from source
+
+Maintainers can build the collection into a temporary directory after
+installing `requirements.yml`:
 
 ```sh
 build_dir=$(mktemp -d)
@@ -22,10 +40,6 @@ ansible-galaxy collection install \
   "$build_dir/rakestraw-dnd-0.1.0.tar.gz" --no-deps
 ```
 
-The development manifest uses immutable role commit pins. A future released
-collection may instead consume reviewed role tags; this repository does not
-claim that version `0.1.0` has been published or tagged.
-
 ## Use
 
 ```yaml
diff --git a/requirements.yml b/requirements.yml
index 115808d..bb22b13 100644
--- a/requirements.yml
+++ b/requirements.yml
@@ -3,23 +3,23 @@ roles:
   - name: rakestraw.seriatim
     src: https://gitea.maximumdirect.net/eric/ansible-role-seriatim.git
     scm: git
-    version: e08c63c0b078658bdfa2d10a2e6e1e4f9372a075
+    version: v0.1.0
   - name: rakestraw.audita
     src: https://gitea.maximumdirect.net/eric/ansible-role-audita.git
     scm: git
-    version: 66ebea9a47ce82bfdbdc5e2855f3dfaaff8e2a16
+    version: v0.1.0
   - name: rakestraw.notarius
     src: https://gitea.maximumdirect.net/eric/ansible-role-notarius.git
     scm: git
-    version: 14a38e04e35ef524d6a97fa7fb5a04981a0a2161
+    version: v0.1.0
   - name: rakestraw.scriptorium
     src: https://gitea.maximumdirect.net/eric/ansible-role-scriptorium.git
     scm: git
-    version: 8b4c86e48e7d8655e479b26dc510bf01683a0c8f
+    version: v0.1.0
   - name: rakestraw.narratio
     src: https://gitea.maximumdirect.net/eric/ansible-role-narratio.git
     scm: git
-    version: 292d8669e7aad5cfe80b0c469d22b6177e8cf0f1
+    version: v0.1.0
 collections:
   - name: ansible.posix
     version: 2.2.0