From b1784c65fc5e7732942f43f77817020d7c3d0357 Mon Sep 17 00:00:00 2001
From: Rootiest <chris@rootiest.com>
Date: Tue, 29 Sep 2026 04:18:45 -0400
Subject: [PATCH] docs(readme): document templates/ and add it to CI paths

Claude-Session: https://claude.ai/code/session_015eE4sQqrZ8yKGkTMf58shs
---
 .github/workflows/ci.yml | 3 ++-
 README.md                | 8 ++++++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 876b019..7615291 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -15,6 +15,7 @@ on:
       - "config.fish"
       - "completions/**"
       - "integrations/**"
+      - "templates/**"
       - "tests/**"
       - "scripts/**"
   pull_request:
@@ -82,7 +83,7 @@ jobs:
           fi
           git fetch origin "${{ github.event.pull_request.base.ref }}"
           if git diff --name-only "origin/${{ github.event.pull_request.base.ref }}...HEAD" \
-              | grep -qE '^(docs/manual/|docs/build-manual\.py$|docs/manualtools\.py$|docs/verify-manual\.py$|docs/site/|functions/|conf\.d/|config\.fish$|completions/|integrations/|tests/|scripts/)'; then
+              | grep -qE '^(docs/manual/|docs/build-manual\.py$|docs/manualtools\.py$|docs/verify-manual\.py$|docs/site/|functions/|conf\.d/|config\.fish$|completions/|integrations/|templates/|tests/|scripts/)'; then
             echo "run=true" >>"$GITHUB_OUTPUT"
           else
             echo "run=false" >>"$GITHUB_OUTPUT"
diff --git a/README.md b/README.md
index 54d67db..0726537 100644
--- a/README.md
+++ b/README.md
@@ -321,6 +321,14 @@ To opt out, set `__fish_user_dots_symlink` to a falsy value (or toggle **Dots li
 
 `fish_variables` (which fish auto-manages and may contain universal variable state) is excluded from this repo via `.gitignore`.
 
+### Function templates
+
+`templates/` holds starting points for your own functions. Each one has a short settings block at the top; edit it and save the file as `<name>.fish` in a directory on `$fish_function_path`.
+
+| Template | Purpose |
+|---|---|
+| `allow-telemetry.fish` | Wrap one command and remove environment variables (default: `DO_NOT_TRACK`, `DISABLE_TELEMETRY`) from that command's process only |
+
 ---
 
 ## Minimal Mode