From dfe322d7542a0605c926d2b76729740adb9342e5 Mon Sep 17 00:00:00 2001
From: Maintainer <274373685+human0-ai[bot]@users.noreply.github.com>
Date: Fri, 2 Oct 2026 20:21:10 +0000
Subject: [PATCH 1/2] fix(registry): track systemd guides tip

---
 packages/registry/src/html-index-build.test.ts |  1 -
 registry/README.md                             | 12 ++++++++----
 registry/systemd/systemd-guides.yaml           |  1 -
 3 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/packages/registry/src/html-index-build.test.ts b/packages/registry/src/html-index-build.test.ts
index 7a6afa1..3657252 100644
--- a/packages/registry/src/html-index-build.test.ts
+++ b/packages/registry/src/html-index-build.test.ts
@@ -147,7 +147,6 @@ describe("HTML index registry integration", () => {
     const guides = loadDefinition(join(root, "systemd-guides.yaml"));
     expect(guides.source).toMatchObject({
       type: "git",
-      ref: "v258",
       docs_path: "docs",
     });
   });
diff --git a/registry/README.md b/registry/README.md
index 14410a9..4aad632 100644
--- a/registry/README.md
+++ b/registry/README.md
@@ -30,16 +30,20 @@ registry/maven/org.springframework.boot_spring-boot.yaml
 ```
 
 **If the project isn't distributed by a package manager at all** — a language runtime,
-a daemon, a CLI tool — give it a directory named after the project containing a single
-self-named file. That's how the language runtimes are already done:
+a daemon, a CLI tool — give it a directory named after the project, with one
+self-named file per package. A single-package project gets a single file, which is
+how the language runtimes are already done:
 
 ```
 registry/python/python.yaml
 registry/java/java.yaml
 ```
 
-So Docker, Kubernetes, Podman and systemd would be `registry/docker/docker.yaml`,
-`registry/kubernetes/kubernetes.yaml`, and so on.
+So Docker, Kubernetes and Podman would be `registry/docker/docker.yaml`,
+`registry/kubernetes/kubernetes.yaml`, `registry/podman/podman.yaml`, and so on.
+A project that ships more than one package gets more than one file in the same
+directory — systemd, for example, has `registry/systemd/systemd.yaml` and
+`registry/systemd/systemd-guides.yaml`.
 
 The `name:` field inside the file must match the path, or loading fails.
 
diff --git a/registry/systemd/systemd-guides.yaml b/registry/systemd/systemd-guides.yaml
index 5a46d09..a6a8187 100644
--- a/registry/systemd/systemd-guides.yaml
+++ b/registry/systemd/systemd-guides.yaml
@@ -5,5 +5,4 @@ repository: https://github.com/systemd/systemd
 source:
   type: git
   url: https://github.com/systemd/systemd
-  ref: v258
   docs_path: docs

From 77a25ba3c4526a0f9ca01bf6833367b5c3c75753 Mon Sep 17 00:00:00 2001
From: Maintainer <274373685+human0-ai[bot]@users.noreply.github.com>
Date: Sat, 3 Oct 2026 00:10:20 +0000
Subject: [PATCH 2/2] test(registry): assert systemd guides is unpinned

---
 packages/registry/src/html-index-build.test.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/registry/src/html-index-build.test.ts b/packages/registry/src/html-index-build.test.ts
index 3657252..bc9a103 100644
--- a/packages/registry/src/html-index-build.test.ts
+++ b/packages/registry/src/html-index-build.test.ts
@@ -149,5 +149,6 @@ describe("HTML index registry integration", () => {
       type: "git",
       docs_path: "docs",
     });
+    expect(guides.source).not.toHaveProperty("ref");
   });
 });