Skip to content

🐛 Fix: Docs button in create sites repositories section #2300 #2302

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

🐛 Fix: Docs button in create sites repositories section #2300 #2302

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d42e08d
fix: update docs button link in create sites repositories
AryanBagade Sep 2, 2025
c576715
fix: update docs button link in create sites repositories
AryanBagade Sep 2, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion src/routes/(console)/project-[region]-[project]/sites/create-site/repositories/+page.svelte
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,9 +66,13 @@
</Typography.Text>
</Layout.Stack>
<Layout.Stack gap="s" direction="row">
<Button href="#" secondary>Docs</Button>
<Button
href="https://appwrite.io/docs/advanced/self-hosting/sites#configure-github-app"
external
secondary>Docs</Button>
Comment on lines +69 to +72
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Verification agent

🧩 Analysis chain

Optional: add tracking/UTM and guard against doc anchor drift.

  • Consider UTM params for attribution and a central constant for the docs URL.
  • Verify the anchor still exists; fail-safe if docs restructure.

Apply UTM (query must precede hash):

-                            href="https://appwrite.io/docs/advanced/self-hosting/sites#configure-github-app"
+                            href="https://appwrite.io/docs/advanced/self-hosting/sites?utm_source=console&utm_medium=button&utm_campaign=sites-missing-repo#configure-github-app"

Verification script:

🏁 Script executed:

#!/bin/bash
set -euo pipefail
base='https://appwrite.io/docs/advanced/self-hosting/sites'
code=$(curl -sL -o /dev/null -w '%{http_code}' "$base")
echo "HTTP $code for $base"
html=$(curl -sL "$base")
if grep -q 'configure-github-app' <<<"$html"; then
  echo "Anchor 'configure-github-app' found"
else
  echo "Anchor 'configure-github-app' NOT found"; exit 1
fi

Length of output: 157427

Fix broken docs anchor and centralize URL

  • In src/routes/(console)/project-[region]-[project]/sites/create-site/repositories/+page.svelte (lines 69–72), change the fragment from #configure-github-app to #git to match the current docs anchor.
  • Extract the docs base URL into a shared constant and append UTM parameters there for consistency.
🤖 Prompt for AI Agents 
In
src/routes/(console)/project-[region]-[project]/sites/create-site/repositories/+page.svelte
around lines 69–72, update the docs link fragment from #configure-github-app to
#git and replace the hardcoded full URL by importing a shared docs base constant
(e.g. from src/lib/constants/docs.ts) that already includes the UTM parameters,
then construct the final href by appending the #git fragment to that base
constant; add or update the shared constant file to export the canonical docs
base URL with UTM params so all components reuse it.

<Button
href={`https://github.com/${data.installations.installations[0].organization}`}
external
text>Go to GitHub</Button>
</Layout.Stack>
{/if}
Expand Down