Update content for gemtext

3 files changed, 105 insertions, 94 deletions

diff --git a/gemfeed/2026-03-02-rcm-ruby-configuration-management-dsl.gmi b/gemfeed/2026-03-02-rcm-ruby-configuration-management-dsl.gmi
index ee9b14be..c3fb639d 100644
--- a/gemfeed/2026-03-02-rcm-ruby-configuration-management-dsl.gmi
+++ b/gemfeed/2026-03-02-rcm-ruby-configuration-management-dsl.gmi
@@ -21,6 +21,16 @@ RCM is a tiny configuration management system written in Ruby. It gives me a sma
 * ⇢ ⇢ Cutting RCM 0.1.0
 * ⇢ ⇢ What's next
 * ⇢ ⇢ Feature overview (selected)
+* ⇢ ⇢ ⇢ Template rendering into a file
+* ⇢ ⇢ ⇢ Ensuring a line is absent from a file
+* ⇢ ⇢ ⇢ Guarding a configuration run on the current hostname
+* ⇢ Creating and deleting directories, and purging a directory tree
+* ⇢ ⇢ ⇢ Managing file and directory modes and ownership
+* ⇢ ⇢ ⇢ Using a chained, more natural language style for notifications
+* ⇢ ⇢ ⇢ Touching files and updating their timestamps
+* ⇢ ⇢ ⇢ Expressing dependencies between notifications
+* ⇢ ⇢ ⇢ Creating and updating symbolic links
+* ⇢ ⇢ ⇢ Detecting duplicate resource definitions at configure time
 
 ## Why I built RCM
 
@@ -41,7 +51,7 @@ configure do
   given { hostname is :earth }
 
   file '/tmp/test/wg0.conf' do
-    requires '/etc/hosts.test'
+    requires file '/etc/hosts.test'
     manage directory
     from template
     'content with <%= 1 + 2 %>'
@@ -53,6 +63,19 @@ configure do
 end
 ```
 
+Which would look like this when run:
+
+```sh
+% sudo ruby example.rb
+INFO 20260301-213817 dsl(0) => Configuring...
+INFO 20260301-213817 file('/tmp/test/wg0.conf') => Registered dependency on file('/etc/hosts.test')
+INFO 20260301-213817 file('/tmp/test/wg0.conf') => Evaluating...
+INFO 20260301-213817 file('/etc/hosts.test') => Evaluating...
+INFO 20260301-213817 file('/etc/hosts.test') => Writing file /etc/hosts.test
+INFO 20260301-213817 file('/tmp/test/wg0.conf') => Creating parent directory /tmp/test
+INFO 20260301-213817 file('/tmp/test/wg0.conf') => Writing file /tmp/test/wg0.conf
+```
+
 The idea is that you describe the desired state and RCM worries about the steps. The `given` block can short‑circuit the whole run (for example, only run on a specific hostname). Each `file` resource can either manage a complete file (from a template) or just make sure individual lines are present.
 
 ### Keywords and resources
@@ -192,7 +215,7 @@ Here is a quick overview of what RCM can do today, grouped by area:
 
 Some small examples adapted from RCM's own tests:
 
-Template rendering into a file:
+### Template rendering into a file
 
 ```ruby
 configure do
@@ -203,7 +226,7 @@ configure do
 end
 ```
 
-Ensuring a line is absent from a file:
+### Ensuring a line is absent from a file
 
 ```ruby
 configure do
@@ -214,34 +237,16 @@ configure do
 end
 ```
 
-Keeping a backup of the original content when a file changes:
-
-```ruby
-configure do
-  file original do
-    path './.dir_example.rcmtmp/foo/backup-me.txt'
-    manage directory
-    'original_content'
-  end
-
-  file new do
-    path './.dir_example.rcmtmp/foo/backup-me.txt'
-    manage directory
-    requires file original
-    'new_content'
-  end
-end
-```
-
-Guarding a configuration run on the current hostname:
+### Guarding a configuration run on the current hostname
 
 ```ruby
 configure do
   given { hostname Socket.gethostname }
+  ...
 end
 ```
 
-Creating and deleting directories, and purging a directory tree:
+# Creating and deleting directories, and purging a directory tree
 
 ```ruby
 configure do
@@ -256,7 +261,7 @@ configure do
 end
 ```
 
-Managing file and directory modes and ownership:
+### Managing file and directory modes and ownership
 
 ```ruby
 configure do
@@ -270,7 +275,9 @@ configure do
 end
 ```
 
-Using a chained, more natural language style for notifications:
+### Using a chained, more natural language style for notifications
+
+This will just print out something, not changing anything:
 
 ```ruby
 configure do
@@ -280,7 +287,7 @@ configure do
 end
 ```
 
-Touching files and updating their timestamps:
+### Touching files and updating their timestamps
 
 ```ruby
 configure do
@@ -288,7 +295,7 @@ configure do
 end
 ```
 
-Expressing dependencies between notifications:
+### Expressing dependencies between notifications
 
 ```ruby
 configure do
@@ -306,7 +313,7 @@ configure do
 end
 ```
 
-Creating and updating symbolic links:
+### Creating and updating symbolic links
 
 ```ruby
 configure do
@@ -317,7 +324,7 @@ configure do
 end
 ```
 
-Detecting duplicate resource definitions at configure time:
+### Detecting duplicate resource definitions at configure time
 
 ```ruby
 configure do
diff --git a/gemfeed/2026-03-02-rcm-ruby-configuration-management-dsl.gmi.tpl b/gemfeed/2026-03-02-rcm-ruby-configuration-management-dsl.gmi.tpl
index 0a83086b..234e78f0 100644
--- a/gemfeed/2026-03-02-rcm-ruby-configuration-management-dsl.gmi.tpl
+++ b/gemfeed/2026-03-02-rcm-ruby-configuration-management-dsl.gmi.tpl
@@ -27,7 +27,7 @@ configure do
   given { hostname is :earth }
 
   file '/tmp/test/wg0.conf' do
-    requires '/etc/hosts.test'
+    requires file '/etc/hosts.test'
     manage directory
     from template
     'content with <%= 1 + 2 %>'
@@ -39,6 +39,19 @@ configure do
 end
 ```
 
+Which would look like this when run:
+
+```sh
+% sudo ruby example.rb
+INFO 20260301-213817 dsl(0) => Configuring...
+INFO 20260301-213817 file('/tmp/test/wg0.conf') => Registered dependency on file('/etc/hosts.test')
+INFO 20260301-213817 file('/tmp/test/wg0.conf') => Evaluating...
+INFO 20260301-213817 file('/etc/hosts.test') => Evaluating...
+INFO 20260301-213817 file('/etc/hosts.test') => Writing file /etc/hosts.test
+INFO 20260301-213817 file('/tmp/test/wg0.conf') => Creating parent directory /tmp/test
+INFO 20260301-213817 file('/tmp/test/wg0.conf') => Writing file /tmp/test/wg0.conf
+```
+
 The idea is that you describe the desired state and RCM worries about the steps. The `given` block can short‑circuit the whole run (for example, only run on a specific hostname). Each `file` resource can either manage a complete file (from a template) or just make sure individual lines are present.
 
 ### Keywords and resources
@@ -178,7 +191,7 @@ Here is a quick overview of what RCM can do today, grouped by area:
 
 Some small examples adapted from RCM's own tests:
 
-Template rendering into a file:
+### Template rendering into a file
 
 ```ruby
 configure do
@@ -189,7 +202,7 @@ configure do
 end
 ```
 
-Ensuring a line is absent from a file:
+### Ensuring a line is absent from a file
 
 ```ruby
 configure do
@@ -200,34 +213,16 @@ configure do
 end
 ```
 
-Keeping a backup of the original content when a file changes:
-
-```ruby
-configure do
-  file original do
-    path './.dir_example.rcmtmp/foo/backup-me.txt'
-    manage directory
-    'original_content'
-  end
-
-  file new do
-    path './.dir_example.rcmtmp/foo/backup-me.txt'
-    manage directory
-    requires file original
-    'new_content'
-  end
-end
-```
-
-Guarding a configuration run on the current hostname:
+### Guarding a configuration run on the current hostname
 
 ```ruby
 configure do
   given { hostname Socket.gethostname }
+  ...
 end
 ```
 
-Creating and deleting directories, and purging a directory tree:
+# Creating and deleting directories, and purging a directory tree
 
 ```ruby
 configure do
@@ -242,7 +237,7 @@ configure do
 end
 ```
 
-Managing file and directory modes and ownership:
+### Managing file and directory modes and ownership
 
 ```ruby
 configure do
@@ -256,7 +251,9 @@ configure do
 end
 ```
 
-Using a chained, more natural language style for notifications:
+### Using a chained, more natural language style for notifications
+
+This will just print out something, not changing anything:
 
 ```ruby
 configure do
@@ -266,7 +263,7 @@ configure do
 end
 ```
 
-Touching files and updating their timestamps:
+### Touching files and updating their timestamps
 
 ```ruby
 configure do
@@ -274,7 +271,7 @@ configure do
 end
 ```
 
-Expressing dependencies between notifications:
+### Expressing dependencies between notifications
 
 ```ruby
 configure do
@@ -292,7 +289,7 @@ configure do
 end
 ```
 
-Creating and updating symbolic links:
+### Creating and updating symbolic links
 
 ```ruby
 configure do
@@ -303,7 +300,7 @@ configure do
 end
 ```
 
-Detecting duplicate resource definitions at configure time:
+### Detecting duplicate resource definitions at configure time
 
 ```ruby
 configure do
diff --git a/gemfeed/atom.xml b/gemfeed/atom.xml
index 671d0af8..4a366f82 100644
--- a/gemfeed/atom.xml
+++ b/gemfeed/atom.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <feed xmlns="http://www.w3.org/2005/Atom">
-    <updated>2026-03-01T21:29:51+02:00</updated>
+    <updated>2026-03-01T21:39:39+02:00</updated>
     <title>foo.zone feed</title>
     <subtitle>To be in the .zone!</subtitle>
     <link href="gemini://foo.zone/gemfeed/atom.xml" rel="self" />
@@ -42,6 +42,16 @@
 <li>⇢ <a href='#cutting-rcm-010'>Cutting RCM 0.1.0</a></li>
 <li>⇢ <a href='#what-s-next'>What&#39;s next</a></li>
 <li>⇢ <a href='#feature-overview-selected'>Feature overview (selected)</a></li>
+<li>⇢ ⇢ <a href='#template-rendering-into-a-file'>Template rendering into a file</a></li>
+<li>⇢ ⇢ <a href='#ensuring-a-line-is-absent-from-a-file'>Ensuring a line is absent from a file</a></li>
+<li>⇢ ⇢ <a href='#guarding-a-configuration-run-on-the-current-hostname'>Guarding a configuration run on the current hostname</a></li>
+<li><a href='#creating-and-deleting-directories-and-purging-a-directory-tree'>Creating and deleting directories, and purging a directory tree</a></li>
+<li>⇢ ⇢ <a href='#managing-file-and-directory-modes-and-ownership'>Managing file and directory modes and ownership</a></li>
+<li>⇢ ⇢ <a href='#using-a-chained-more-natural-language-style-for-notifications'>Using a chained, more natural language style for notifications</a></li>
+<li>⇢ ⇢ <a href='#touching-files-and-updating-their-timestamps'>Touching files and updating their timestamps</a></li>
+<li>⇢ ⇢ <a href='#expressing-dependencies-between-notifications'>Expressing dependencies between notifications</a></li>
+<li>⇢ ⇢ <a href='#creating-and-updating-symbolic-links'>Creating and updating symbolic links</a></li>
+<li>⇢ ⇢ <a href='#detecting-duplicate-resource-definitions-at-configure-time'>Detecting duplicate resource definitions at configure time</a></li>
 </ul><br />
 <h2 style='display: inline' id='why-i-built-rcm'>Why I built RCM</h2><br />
 <br />
@@ -65,7 +75,7 @@ http://www.gnu.org/software/src-highlite -->
   given { hostname is :earth }
 
   file <font color="#808080">'/tmp/test/wg0.conf'</font> <b><u><font color="#000000">do</font></u></b>
-    requires <font color="#808080">'/etc/hosts.test'</font>
+    requires file <font color="#808080">'/etc/hosts.test'</font>
     manage directory
     from template
     <font color="#808080">'content with &lt;%= 1 + 2 %&gt;'</font>
@@ -77,6 +87,22 @@ http://www.gnu.org/software/src-highlite -->
 <b><u><font color="#000000">end</font></u></b>
 </pre>
 <br />
+<span>Which would look like this when run:</span><br />
+<br />
+<!-- Generator: GNU source-highlight 3.1.9
+by Lorenzo Bettini
+http://www.lorenzobettini.it
+http://www.gnu.org/software/src-highlite -->
+<pre>% sudo ruby example.rb
+INFO <font color="#000000">20260301</font>-<font color="#000000">213817</font> dsl(<font color="#000000">0</font>) =&gt; Configuring...
+INFO <font color="#000000">20260301</font>-<font color="#000000">213817</font> file(<font color="#808080">'/tmp/test/wg0.conf'</font>) =&gt; Registered dependency on file(<font color="#808080">'/etc/hosts.test'</font>)
+INFO <font color="#000000">20260301</font>-<font color="#000000">213817</font> file(<font color="#808080">'/tmp/test/wg0.conf'</font>) =&gt; Evaluating...
+INFO <font color="#000000">20260301</font>-<font color="#000000">213817</font> file(<font color="#808080">'/etc/hosts.test'</font>) =&gt; Evaluating...
+INFO <font color="#000000">20260301</font>-<font color="#000000">213817</font> file(<font color="#808080">'/etc/hosts.test'</font>) =&gt; Writing file /etc/hosts.<b><u><font color="#000000">test</font></u></b>
+INFO <font color="#000000">20260301</font>-<font color="#000000">213817</font> file(<font color="#808080">'/tmp/test/wg0.conf'</font>) =&gt; Creating parent directory /tmp/test
+INFO <font color="#000000">20260301</font>-<font color="#000000">213817</font> file(<font color="#808080">'/tmp/test/wg0.conf'</font>) =&gt; Writing file /tmp/test/wg<font color="#000000">0</font>.conf
+</pre>
+<br />
 <span>The idea is that you describe the desired state and RCM worries about the steps. The <span class='inlinecode'>given</span> block can short‑circuit the whole run (for example, only run on a specific hostname). Each <span class='inlinecode'>file</span> resource can either manage a complete file (from a template) or just make sure individual lines are present.</span><br />
 <br />
 <h3 style='display: inline' id='keywords-and-resources'>Keywords and resources</h3><br />
@@ -234,7 +260,7 @@ HostCondition.new.hostname.is(:earth)
 </ul><br />
 <span>Some small examples adapted from RCM&#39;s own tests:</span><br />
 <br />
-<span>Template rendering into a file:</span><br />
+<h3 style='display: inline' id='template-rendering-into-a-file'>Template rendering into a file</h3><br />
 <br />
 <!-- Generator: GNU source-highlight 3.1.9
 by Lorenzo Bettini
@@ -248,7 +274,7 @@ http://www.gnu.org/software/src-highlite -->
 <b><u><font color="#000000">end</font></u></b>
 </pre>
 <br />
-<span>Ensuring a line is absent from a file:</span><br />
+<h3 style='display: inline' id='ensuring-a-line-is-absent-from-a-file'>Ensuring a line is absent from a file</h3><br />
 <br />
 <!-- Generator: GNU source-highlight 3.1.9
 by Lorenzo Bettini
@@ -262,29 +288,7 @@ http://www.gnu.org/software/src-highlite -->
 <b><u><font color="#000000">end</font></u></b>
 </pre>
 <br />
-<span>Keeping a backup of the original content when a file changes:</span><br />
-<br />
-<!-- Generator: GNU source-highlight 3.1.9
-by Lorenzo Bettini
-http://www.lorenzobettini.it
-http://www.gnu.org/software/src-highlite -->
-<pre>configure <b><u><font color="#000000">do</font></u></b>
-  file original <b><u><font color="#000000">do</font></u></b>
-    path <font color="#808080">'./.dir_example.rcmtmp/foo/backup-me.txt'</font>
-    manage directory
-    <font color="#808080">'original_content'</font>
-  <b><u><font color="#000000">end</font></u></b>
-
-  file new <b><u><font color="#000000">do</font></u></b>
-    path <font color="#808080">'./.dir_example.rcmtmp/foo/backup-me.txt'</font>
-    manage directory
-    requires file original
-    <font color="#808080">'new_content'</font>
-  <b><u><font color="#000000">end</font></u></b>
-<b><u><font color="#000000">end</font></u></b>
-</pre>
-<br />
-<span>Guarding a configuration run on the current hostname:</span><br />
+<h3 style='display: inline' id='guarding-a-configuration-run-on-the-current-hostname'>Guarding a configuration run on the current hostname</h3><br />
 <br />
 <!-- Generator: GNU source-highlight 3.1.9
 by Lorenzo Bettini
@@ -292,10 +296,11 @@ http://www.lorenzobettini.it
 http://www.gnu.org/software/src-highlite -->
 <pre>configure <b><u><font color="#000000">do</font></u></b>
   given { hostname Socket.gethostname }
+  ...
 <b><u><font color="#000000">end</font></u></b>
 </pre>
 <br />
-<span>Creating and deleting directories, and purging a directory tree:</span><br />
+<h1 style='display: inline' id='creating-and-deleting-directories-and-purging-a-directory-tree'>Creating and deleting directories, and purging a directory tree</h1><br />
 <br />
 <!-- Generator: GNU source-highlight 3.1.9
 by Lorenzo Bettini
@@ -313,7 +318,7 @@ http://www.gnu.org/software/src-highlite -->
 <b><u><font color="#000000">end</font></u></b>
 </pre>
 <br />
-<span>Managing file and directory modes and ownership:</span><br />
+<h3 style='display: inline' id='managing-file-and-directory-modes-and-ownership'>Managing file and directory modes and ownership</h3><br />
 <br />
 <!-- Generator: GNU source-highlight 3.1.9
 by Lorenzo Bettini
@@ -330,7 +335,9 @@ http://www.gnu.org/software/src-highlite -->
 <b><u><font color="#000000">end</font></u></b>
 </pre>
 <br />
-<span>Using a chained, more natural language style for notifications:</span><br />
+<h3 style='display: inline' id='using-a-chained-more-natural-language-style-for-notifications'>Using a chained, more natural language style for notifications</h3><br />
+<br />
+<span>This will just print out something, not changing anything:</span><br />
 <br />
 <!-- Generator: GNU source-highlight 3.1.9
 by Lorenzo Bettini
@@ -343,7 +350,7 @@ http://www.gnu.org/software/src-highlite -->
 <b><u><font color="#000000">end</font></u></b>
 </pre>
 <br />
-<span>Touching files and updating their timestamps:</span><br />
+<h3 style='display: inline' id='touching-files-and-updating-their-timestamps'>Touching files and updating their timestamps</h3><br />
 <br />
 <!-- Generator: GNU source-highlight 3.1.9
 by Lorenzo Bettini
@@ -354,7 +361,7 @@ http://www.gnu.org/software/src-highlite -->
 <b><u><font color="#000000">end</font></u></b>
 </pre>
 <br />
-<span>Expressing dependencies between notifications:</span><br />
+<h3 style='display: inline' id='expressing-dependencies-between-notifications'>Expressing dependencies between notifications</h3><br />
 <br />
 <!-- Generator: GNU source-highlight 3.1.9
 by Lorenzo Bettini
@@ -375,7 +382,7 @@ http://www.gnu.org/software/src-highlite -->
 <b><u><font color="#000000">end</font></u></b>
 </pre>
 <br />
-<span>Creating and updating symbolic links:</span><br />
+<h3 style='display: inline' id='creating-and-updating-symbolic-links'>Creating and updating symbolic links</h3><br />
 <br />
 <!-- Generator: GNU source-highlight 3.1.9
 by Lorenzo Bettini
@@ -389,7 +396,7 @@ http://www.gnu.org/software/src-highlite -->
 <b><u><font color="#000000">end</font></u></b>
 </pre>
 <br />
-<span>Detecting duplicate resource definitions at configure time:</span><br />
+<h3 style='display: inline' id='detecting-duplicate-resource-definitions-at-configure-time'>Detecting duplicate resource definitions at configure time</h3><br />
 <br />
 <!-- Generator: GNU source-highlight 3.1.9
 by Lorenzo Bettini