Skip to content

fix-docs-links-and-paths#150

Merged
schacon merged 3 commits intomainfrom
fix-docs-links-and-paths
Feb 4, 2026
Merged

fix-docs-links-and-paths#150
schacon merged 3 commits intomainfrom
fix-docs-links-and-paths

Conversation

@schacon
Copy link
Member

@schacon schacon commented Feb 4, 2026

No description provided.

Update several documentation links that previously caused 404s or
pointed to the wrong paths. Replace a broken Notion external link with
an internal docs reference, correct a misspelled "insepecting" path to
"inspecting", and change absolute /docs/... links to the correct
/features/... paths so related-features links resolve properly.
The GitHub Actions broken link checker was flagging “give us
feedback” links as broken due to HTTP 429 (rate limiting) responses.
Adjust the filter to treat HTTP_429 like redirects (HTTP_308) and
exclude them from the list of links that require attention, so the
checker concentrates on true 404s and other genuine broken links.
Do not treat links starting with
"https://github.com/gitbutlerapp/gitbutler-docs/issues" as special-case
broken links. This adds that URL prefix to the broken-link-checker
excludedKeywords so issue links on the GitHub repo are ignored by the
checker, preventing false positives when scanning documentation.
@vercel
Copy link
Contributor

vercel bot commented Feb 4, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
gitbutler-docs Ready Ready Preview, Comment Feb 4, 2026 11:29am

Request Review

@schacon schacon merged commit e4b9fb8 into main Feb 4, 2026
3 checks passed
@schacon schacon deleted the fix-docs-links-and-paths branch February 4, 2026 11:29
@github-actions
Copy link

github-actions bot commented Feb 4, 2026

Broken Link Checker

36 broken links found. Links organised below by source page, or page where they were found.

1) /cli-guides/cli-tutorial/branching-and-commiting

Target Link Link Text Reason
/cli-guides/rubbing "Rubbing" HTTP_404

2) /troubleshooting/fetch-push

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22troubleshooting/fetch-push%22 "Give us feedback" HTTP_429

3) /troubleshooting/fixing-conflicts-outside-gitbutler

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22troubleshooting/fixing-conflicts-outside-gitbutler%22 "Give us feedback" HTTP_429

4) /commands/commands-overview

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/commands-overview%22 "Give us feedback" HTTP_429

5) /commands/but-setup

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-setup%22 "Give us feedback" HTTP_429

6) /commands/but-teardown

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-teardown%22 "Give us feedback" HTTP_429

7) /commands/but-status

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-status%22 "Give us feedback" HTTP_429

8) /commands/but-diff

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-diff%22 "Give us feedback" HTTP_429

9) /commands/but-show

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-show%22 "Give us feedback" HTTP_429

10) /commands/but-commit

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-commit%22 "Give us feedback" HTTP_429

11) /commands/but-stage

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-stage%22 "Give us feedback" HTTP_429

12) /commands/but-branch

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-branch%22 "Give us feedback" HTTP_429

13) /commands/but-merge

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-merge%22 "Give us feedback" HTTP_429

14) /commands/but-resolve

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-resolve%22 "Give us feedback" HTTP_429

15) /commands/but-mark

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-mark%22 "Give us feedback" HTTP_429

16) /commands/but-push

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-push%22 "Give us feedback" HTTP_429

17) /commands/but-pull

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-pull%22 "Give us feedback" HTTP_429

18) /commands/but-pr

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-pr%22 "Give us feedback" HTTP_429

19) /commands/but-rub

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-rub%22 "Give us feedback" HTTP_429

20) /commands/but-absorb

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-absorb%22 "Give us feedback" HTTP_429

21) /commands/but-reword

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-reword%22 "Give us feedback" HTTP_429

22) /commands/but-uncommit

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-uncommit%22 "Give us feedback" HTTP_429

23) /commands/but-amend

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-amend%22 "Give us feedback" HTTP_429

24) /commands/but-squash

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-squash%22 "Give us feedback" HTTP_429

25) /commands/but-move

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-move%22 "Give us feedback" HTTP_429

26) /commands/but-oplog

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-oplog%22 "Give us feedback" HTTP_429

27) /commands/but-undo

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-undo%22 "Give us feedback" HTTP_429

28) /commands/but-gui

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-gui%22 "Give us feedback" HTTP_429

29) /commands/but-update

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-update%22 "Give us feedback" HTTP_429

30) /commands/but-config

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-config%22 "Give us feedback" HTTP_429

31) /community/open-source

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22community/open-source%22 "Give us feedback" HTTP_429

32) /features/forge-integration/gitlab-integration

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22features/forge-integration/gitlab-integration%22 "Give us feedback" HTTP_429

33) /commands/but-pick

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22commands/but-pick%22 "Give us feedback" HTTP_429

34) /features/ai-integration/ai-overview

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22features/ai-integration/ai-overview%22 "Give us feedback" HTTP_429

35) /features/ai-integration/mcp-server

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22features/ai-integration/mcp-server%22 "Give us feedback" HTTP_429

36) /features/ai-integration/claude-code-hooks

Target Link Link Text Reason
https://github.com/gitbutlerapp/gitbutler-docs/issues/new?label=docs&title=Feedback+for+page+%22features/ai-integration/claude-code-hooks%22 "Give us feedback" HTTP_429

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant