[PR #363] [MERGED] feat(www): SEO overhaul with sitemap, metadata, interlinking, and five new articles #8970

Closed
opened 2026-08-30 22:04:48 -05:00 by GiteaMirror · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/RayLabsHQ/gitea-mirror/pull/363
Author: @arunavo4
Created: 8/20/2026
Status: ✅ Merged
Merged: 8/20/2026
Merged by: @arunavo4

Base: main ← Head: feat/www-seo


📝 Commits (2)

  • 2a20e9d feat(www): generated sitemap, article metadata, and de-orphaned comparison page
  • c1aaccb feat(www): five new articles and an interlinking pass

📊 Changes

27 files changed (+610 additions, -63 deletions)

View changed files

📝 www/astro.config.mjs (+4 -1)
📝 www/package.json (+1 -0)
📝 www/pnpm-lock.yaml (+71 -32)
📝 www/public/robots.txt (+1 -5)
➖ www/public/sitemap.xml (+0 -9)
📝 www/src/components/Footer.astro (+10 -4)
📝 www/src/components/Header.tsx (+1 -0)
📝 www/src/components/UseCases.astro (+8 -1)
📝 www/src/layouts/DocsLayout.astro (+15 -0)
📝 www/src/layouts/UseCaseIndexLayout.astro (+7 -1)
📝 www/src/layouts/UseCaseLayout.astro (+23 -1)
📝 www/src/lib/use-cases.ts (+40 -0)
📝 www/src/pages/comparison/github-backup-tools.mdx (+3 -1)
📝 www/src/pages/docs/quickstart.mdx (+1 -0)
📝 www/src/pages/use-cases/backup-github-repositories.mdx (+8 -1)
📝 www/src/pages/use-cases/deploy-with-helm-chart.mdx (+5 -0)
➕ www/src/pages/use-cases/github-api-rate-limits.mdx (+62 -0)
📝 www/src/pages/use-cases/github-backup-automation.mdx (+7 -1)
➕ www/src/pages/use-cases/migrate-github-to-gitea.mdx (+93 -0)
➕ www/src/pages/use-cases/mirror-git-lfs-repositories.mdx (+66 -0)

...and 7 more files

📄 Description

SEO overhaul for the marketing site, from the full-site review.

Structural fixes

  • Sitemap now covers the whole site. The hand-written public/sitemap.xml listed one URL (the homepage, dated January 2025). @astrojs/sitemap now generates it on every build: 27 URLs. site is set in astro.config.mjs and robots.txt points at the generated index.
  • Comparison page de-orphaned. /comparison/github-backup-tools/ had zero inbound links. It is now in the header nav ("Compare"), the footer, and the homepage use-cases section, so every page links to it.
  • OG/Twitter tags on use-case pages. UseCaseLayout and UseCaseIndexLayout stopped at title/description/canonical, so shares rendered no card. Both now match the DocsLayout pattern, plus minimal TechArticle JSON-LD on article layouts.
  • Footer "Documentation" now points at /docs/ (canonical since #354) instead of the GitHub tree.

Five new articles

Each grounded in shipped behavior rather than generic content:

  • Migrate from GitHub to Gitea: the parallel-run migration playbook. Highest-intent query the product serves; nothing targeted it.
  • Mirror Git LFS repositories: why one bad LFS repo fails its entire Gitea migration and the per-repo override from v3.27.0 (#361/#362) that fixes it.
  • GitHub API rate limits: what 5,000/hour means for mirroring and how the ETag conditional requests shipped in 3.26 make unchanged checks free.
  • Mirror issues and pull requests: what transfers, the honest PR-to-issue conversion, why processing is sequential.
  • GitHub backup on Unraid: install guide based on the RayLabsHQ CA template (verified against the template XML: image, port, paths, env vars).

New entries are appended after the existing ones so the homepage's featured three are unchanged.

Interlinking pass

Articles previously carried 0 to 4 internal links each and the docs never linked to use-cases. Now every article has 4 to 9 contextual links plus a short related-guides section, the comparison page's next steps cover the new guides, and the docs quickstart bridges into the use-case section. A build-time check resolves all 440 internal links against built pages: 0 broken.

Verification

pnpm build passes, 27 pages. Sitemap, canonicals, and nav links agree on trailing-slash style. No changes outside www/.


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/RayLabsHQ/gitea-mirror/pull/363 **Author:** [@arunavo4](https://github.com/arunavo4) **Created:** 8/20/2026 **Status:** ✅ Merged **Merged:** 8/20/2026 **Merged by:** [@arunavo4](https://github.com/arunavo4) **Base:** `main` ← **Head:** `feat/www-seo` --- ### 📝 Commits (2) - [`2a20e9d`](https://github.com/RayLabsHQ/gitea-mirror/commit/2a20e9d1ad70e9737ecfbb753b89ec6ee3558f44) feat(www): generated sitemap, article metadata, and de-orphaned comparison page - [`c1aaccb`](https://github.com/RayLabsHQ/gitea-mirror/commit/c1aaccbd8603d8f4600fa5849ac4b079739d0e19) feat(www): five new articles and an interlinking pass ### 📊 Changes **27 files changed** (+610 additions, -63 deletions) <details> <summary>View changed files</summary> 📝 `www/astro.config.mjs` (+4 -1) 📝 `www/package.json` (+1 -0) 📝 `www/pnpm-lock.yaml` (+71 -32) 📝 `www/public/robots.txt` (+1 -5) ➖ `www/public/sitemap.xml` (+0 -9) 📝 `www/src/components/Footer.astro` (+10 -4) 📝 `www/src/components/Header.tsx` (+1 -0) 📝 `www/src/components/UseCases.astro` (+8 -1) 📝 `www/src/layouts/DocsLayout.astro` (+15 -0) 📝 `www/src/layouts/UseCaseIndexLayout.astro` (+7 -1) 📝 `www/src/layouts/UseCaseLayout.astro` (+23 -1) 📝 `www/src/lib/use-cases.ts` (+40 -0) 📝 `www/src/pages/comparison/github-backup-tools.mdx` (+3 -1) 📝 `www/src/pages/docs/quickstart.mdx` (+1 -0) 📝 `www/src/pages/use-cases/backup-github-repositories.mdx` (+8 -1) 📝 `www/src/pages/use-cases/deploy-with-helm-chart.mdx` (+5 -0) ➕ `www/src/pages/use-cases/github-api-rate-limits.mdx` (+62 -0) 📝 `www/src/pages/use-cases/github-backup-automation.mdx` (+7 -1) ➕ `www/src/pages/use-cases/migrate-github-to-gitea.mdx` (+93 -0) ➕ `www/src/pages/use-cases/mirror-git-lfs-repositories.mdx` (+66 -0) _...and 7 more files_ </details> ### 📄 Description SEO overhaul for the marketing site, from the full-site review. ## Structural fixes - **Sitemap now covers the whole site.** The hand-written `public/sitemap.xml` listed one URL (the homepage, dated January 2025). `@astrojs/sitemap` now generates it on every build: 27 URLs. `site` is set in `astro.config.mjs` and `robots.txt` points at the generated index. - **Comparison page de-orphaned.** `/comparison/github-backup-tools/` had zero inbound links. It is now in the header nav ("Compare"), the footer, and the homepage use-cases section, so every page links to it. - **OG/Twitter tags on use-case pages.** `UseCaseLayout` and `UseCaseIndexLayout` stopped at title/description/canonical, so shares rendered no card. Both now match the DocsLayout pattern, plus minimal `TechArticle` JSON-LD on article layouts. - Footer "Documentation" now points at `/docs/` (canonical since #354) instead of the GitHub tree. ## Five new articles Each grounded in shipped behavior rather than generic content: - **Migrate from GitHub to Gitea**: the parallel-run migration playbook. Highest-intent query the product serves; nothing targeted it. - **Mirror Git LFS repositories**: why one bad LFS repo fails its entire Gitea migration and the per-repo override from v3.27.0 (#361/#362) that fixes it. - **GitHub API rate limits**: what 5,000/hour means for mirroring and how the ETag conditional requests shipped in 3.26 make unchanged checks free. - **Mirror issues and pull requests**: what transfers, the honest PR-to-issue conversion, why processing is sequential. - **GitHub backup on Unraid**: install guide based on the RayLabsHQ CA template (verified against the template XML: image, port, paths, env vars). New entries are appended after the existing ones so the homepage's featured three are unchanged. ## Interlinking pass Articles previously carried 0 to 4 internal links each and the docs never linked to use-cases. Now every article has 4 to 9 contextual links plus a short related-guides section, the comparison page's next steps cover the new guides, and the docs quickstart bridges into the use-case section. A build-time check resolves all 440 internal links against built pages: 0 broken. ## Verification `pnpm build` passes, 27 pages. Sitemap, canonicals, and nav links agree on trailing-slash style. No changes outside `www/`. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
GiteaMirror added the pull-request label 2026-08-30 22:04:48 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/gitea-mirror#8970