Skip to content

docs: point at the canonical docs domain, and fix the tap link - #191

Merged
AdamXweb merged 1 commit into
mainfrom
docs/canonical-docs-domain
Aug 9, 2026
Merged

docs: point at the canonical docs domain, and fix the tap link#191
AdamXweb merged 1 commit into
mainfrom
docs/canonical-docs-domain

Conversation

@adamXbot

@adamXbot adamXbot commented Aug 7, 2026

Copy link
Copy Markdown
Collaborator

Found during an accuracy sweep of the privacykey docs and website repos.

The docs domain

This repo references privacytracker-docs.privacykey.org in 29 files. That host does not resolve, and it isn't the agreed scheme — docs sites are docs.<product>.privacykey.org, which docs-privacysentinel already uses. Replaced throughout.

Most of these are user-facing, not internal notes:

Where What the reader sees
README.md (×7) The masthead Documentation link, and every "learn more" pointer
src-tauri/src/app_menu.rs The desktop app's Help menu item
.github/SECURITY.md, SUPPORT.md Where to report a vulnerability, where to get help
6 app components In-app help links from Settings, annotations, audit-bundle import, dev options, focus cards

So today a user clicking Help in the shipped macOS app lands on a dead host.

The Homebrew tap link

README.md linked the tap as github.com/privacykey/tap → 404. The repo is privacykey/homebrew-tap. The brew tap privacykey/tap command directly above it is correct, since brew expands the short form — only the hyperlink was wrong.

Scope

Every edit is a URL string; no behaviour changes. Worth noting the domain still needs DNS + Mintlify connect before any of these resolve — this change makes sure they point at the right name when it goes up.

Companion PR: privacykey/docs-privacytracker#2 (which also corrects the Plausible domain from docs.privacytracker.io).

The docs domain scheme is docs.<product>.privacykey.org — the form
docs-privacysentinel already uses. This repo referenced
privacytracker-docs.privacykey.org in 29 files, which does not resolve and
never will under that name.

Most of these are user-facing rather than internal notes:
- README.md links it 7 times, including the masthead Documentation link.
- src-tauri/src/app_menu.rs is the desktop app's Help menu.
- .github/SECURITY.md, SUPPORT.md, and in-app help links in SettingsView,
  AnnotationsSidebar, AuditBundleImport, DevOptionsFeatureFlagPanel,
  YourFocusCard and FocusPreviewBanner.

Separately: the README's Homebrew tap link pointed at
github.com/privacykey/tap, which 404s. The repo is privacykey/homebrew-tap.
The `brew tap privacykey/tap` command above it is correct — brew expands the
short form — so only the hyperlink was wrong.

Neither change affects behaviour; every edit is a URL string.
@adamXbot
adamXbot requested a review from AdamXweb as a code owner August 7, 2026 15:53
@AdamXweb
AdamXweb merged commit 2ef81e0 into main Aug 9, 2026
16 checks passed
@AdamXweb
AdamXweb deleted the docs/canonical-docs-domain branch August 9, 2026 08:25
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.

2 participants