From 1e7c243e60f4723692fcb85c9e14ed8ecb84bd05 Mon Sep 17 00:00:00 2001
From: Michael Anderson <michael.anderson@trackdub.com>
Date: Sat, 31 Oct 2026 05:49:45 -0700
Subject: [PATCH] docs(custom-completions): add layout and pinning guidance for
 packagers (#1266)

---
 custom-completions/README.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/custom-completions/README.md b/custom-completions/README.md
index 508df7447..4fedde55d 100644
--- a/custom-completions/README.md
+++ b/custom-completions/README.md
@@ -21,3 +21,15 @@ export extern rustup [
 ]
 ```
 `use ./rustup.nu *` won't work here
+
+## For packagers
+
+Preferred layout per tool:
+
+```text
+custom-completions/<tool>/
+  readme.md
+  <tool>-completions.nu
+```
+
+Pin a git revision and path into that folder (or the whole tree). Prefer stable directory names; renames break links and package ids. This repo does not host release zip/tar assets for these trees.