From dce4510674ec7014e300adc3daffbe1cde3d3d3e Mon Sep 17 00:00:00 2001 From: Branimir Georgiev Date: Sun, 26 Apr 2026 09:29:01 +0300 Subject: [PATCH] fix: use URL-relative paths for recipe-to-recipe cross-references The remark sibling rewriter turns slug.md into slug/, which resolves to /playbook/current/slug/ instead of /playbook/slug/. Use ../slug/ directly so the rewriter leaves the link untouched and the browser resolves it correctly. Co-Authored-By: Claude Opus 4.6 (1M context) --- chapters/recipes/commit-msg-hook.md | 2 +- chapters/recipes/debugging.md | 2 +- chapters/recipes/git-bisect.md | 2 +- chapters/recipes/hooks.md | 4 ++-- chapters/recipes/pre-commit-hook.md | 2 +- chapters/recipes/remote-management.md | 2 +- chapters/recipes/remove-submodule.md | 2 +- chapters/recipes/submodules.md | 2 +- 8 files changed, 9 insertions(+), 9 deletions(-) diff --git a/chapters/recipes/commit-msg-hook.md b/chapters/recipes/commit-msg-hook.md index 710bde6..9242da1 100644 --- a/chapters/recipes/commit-msg-hook.md +++ b/chapters/recipes/commit-msg-hook.md @@ -51,5 +51,5 @@ $ chmod +x .git/hooks/commit-msg ### Sharing and bypassing -Same as other hooks — see the [Hooks](hooks.md) recipe for +Same as other hooks — see the [Hooks](../hooks/) recipe for `core.hooksPath` and `--no-verify`. diff --git a/chapters/recipes/debugging.md b/chapters/recipes/debugging.md index 4f7af80..82852fe 100644 --- a/chapters/recipes/debugging.md +++ b/chapters/recipes/debugging.md @@ -9,7 +9,7 @@ order: 80 ### Find which commit introduced a bug -Use [Git Bisect](git-bisect.md) for a full walkthrough of manual and +Use [Git Bisect](../git-bisect/) for a full walkthrough of manual and automated binary search through commit history. ### See who last changed each line diff --git a/chapters/recipes/git-bisect.md b/chapters/recipes/git-bisect.md index 7c08b4b..530defd 100644 --- a/chapters/recipes/git-bisect.md +++ b/chapters/recipes/git-bisect.md @@ -54,4 +54,4 @@ commit when done. - Use `git bisect log` to replay or share a bisect session. For blame, log search, and other debugging tools, see the -[Debugging](debugging.md) recipe. +[Debugging](../debugging/) recipe. diff --git a/chapters/recipes/hooks.md b/chapters/recipes/hooks.md index 61449e2..cae5c67 100644 --- a/chapters/recipes/hooks.md +++ b/chapters/recipes/hooks.md @@ -9,12 +9,12 @@ order: 83 ### Create a pre-commit hook -See [Pre-commit Hook](pre-commit-hook.md) for a full walkthrough — +See [Pre-commit Hook](../pre-commit-hook/) for a full walkthrough — script creation, common checks, and sharing with the team. ### Create a commit-msg hook -See [Commit-msg Hook](commit-msg-hook.md) for a full walkthrough — +See [Commit-msg Hook](../commit-msg-hook/) for a full walkthrough — message validation, Conventional Commits enforcement, and examples. ### Share hooks with the team diff --git a/chapters/recipes/pre-commit-hook.md b/chapters/recipes/pre-commit-hook.md index 0abee0a..f8a06e1 100644 --- a/chapters/recipes/pre-commit-hook.md +++ b/chapters/recipes/pre-commit-hook.md @@ -46,7 +46,7 @@ $ chmod +x .git/hooks/pre-commit ### Sharing pre-commit hooks Hooks in `.git/hooks/` are local and not committed. To share them -with the team, see the [Hooks](hooks.md) recipe for the +with the team, see the [Hooks](../hooks/) recipe for the `core.hooksPath` approach. ### Bypassing diff --git a/chapters/recipes/remote-management.md b/chapters/recipes/remote-management.md index 1b9c722..e08282b 100644 --- a/chapters/recipes/remote-management.md +++ b/chapters/recipes/remote-management.md @@ -46,6 +46,6 @@ $ git remote set-url origin git@github.com:/.git ### Set up SSH authentication -See [SSH Setup](ssh-setup.md) for a full walkthrough — key +See [SSH Setup](../ssh-setup/) for a full walkthrough — key generation, agent configuration, GitHub registration, and troubleshooting. diff --git a/chapters/recipes/remove-submodule.md b/chapters/recipes/remove-submodule.md index 365863a..ebbb58a 100644 --- a/chapters/recipes/remove-submodule.md +++ b/chapters/recipes/remove-submodule.md @@ -41,5 +41,5 @@ $ git commit -m "Remove submodule" - **Nested submodules** — if the submodule itself contains submodules, you need to deinit recursively or clean up `.git/modules/` manually. -For other submodule operations, see the [Submodules](submodules.md) +For other submodule operations, see the [Submodules](../submodules/) recipe. diff --git a/chapters/recipes/submodules.md b/chapters/recipes/submodules.md index 44a8cb5..228d70c 100644 --- a/chapters/recipes/submodules.md +++ b/chapters/recipes/submodules.md @@ -43,6 +43,6 @@ $ git commit -m "Update submodule" ### Remove a submodule -See [Remove a Submodule](remove-submodule.md) for a full +See [Remove a Submodule](../remove-submodule/) for a full walkthrough — the three cleanup steps, what each does, and common gotchas.