Skip to content

seo: robots, sitemap, real 404, social/structured data, comparison pages - #13

Merged
tieuanhquoc merged 1 commit into
masterfrom
seo/site-and-repo
Oct 5, 2026
Merged

tieuanhquoc merged 1 commit into
masterfrom
seo/site-and-repo

Conversation

@tieuanhquoc

Copy link
Copy Markdown
Collaborator

Summary

SEO groundwork for https://dockz.nextagesoft.com (served from landing/ by Cloudflare).

Problems found

  • Every path (/robots.txt, /sitemap.xml, typos) returned the home page with 200 — search engines see duplicate "soft 404" pages and no sitemap.
  • No Open Graph / Twitter tags (no preview card when the link is shared), no canonical URL, no structured data.

Changes

  • robots.txt + sitemap.xml (home + comparison pages).
  • 404.html (noindex) and wrangler.jsonc → "not_found_handling": "404-page" so unknown paths answer 404. (Cloudflare Pages also serves a root 404.html with status 404.)
  • Home page: canonical, Open Graph + Twitter card with social-preview.png (1280×640), JSON-LD SoftwareApplication (free, macOS, download URL, version) and FAQPage, a visible FAQ section, "Compare" links.
  • New pages /vs/docker-desktop/, /vs/orbstack/, /vs/colima/ — comparison table, an honest "when the other tool is the better choice", switching steps, download CTA, BreadcrumbList JSON-LD. Claims come from the README comparison and each product's public docs; dated "October 2026" with an issue link for corrections.
  • README: website link → dockz.nextagesoft.com; Colima's Kubernetes cell corrected from "manual" to "single-node k3s (--kubernetes)".

Reviewer notes

  • Docs/site only → CI skips the macOS build.
  • After deploy: submit https://dockz.nextagesoft.com/sitemap.xml in Google Search Console (needs domain verification by the owner).

Test plan

  • JSON-LD parses on all pages (home 2 blocks, comparison pages 1, 404 none).
  • Served locally: comparison pages and FAQ render in the site's dark theme; nav wraps on narrow screens.
  • After deploy: /robots.txt and /sitemap.xml return text/xml, /nope returns 404, link preview shows the card (e.g. opengraph.xyz).

🤖 Generated with Claude Code

The site answered every path (robots.txt, sitemap.xml, typos) with the
home page and HTTP 200, had no Open Graph/Twitter tags, no canonical URL
and no structured data.

- landing/robots.txt, landing/sitemap.xml (home + comparison pages) on
  https://dockz.nextagesoft.com.
- landing/404.html (noindex) and wrangler `not_found_handling: 404-page`
  so unknown paths return 404.
- Home: canonical, Open Graph + Twitter card (social-preview.png,
  1280×640), JSON-LD SoftwareApplication and FAQPage, an FAQ section
  (README's FAQ + remote engines), "Compare" in nav and footer.
- /vs/docker-desktop/, /vs/orbstack/, /vs/colima/: comparison tables,
  honest "when the other tool is the better choice", switching steps;
  shared assets/page.css; BreadcrumbList JSON-LD.
- README: website link → dockz.nextagesoft.com; Colima's Kubernetes cell
  corrected to single-node k3s (`colima start --kubernetes`).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown
Contributor

Deploying dockz with  Cloudflare Pages  Cloudflare Pages

Latest commit: 7f6913e
Status: ✅  Deploy successful!
Preview URL: https://9cabbbe4.dockz.pages.dev
Branch Preview URL: https://seo-site-and-repo.dockz.pages.dev

View logs

@tieuanhquoc
tieuanhquoc merged commit 56d40ad into master Oct 5, 2026
3 checks passed
@tieuanhquoc
tieuanhquoc deleted the seo/site-and-repo branch October 5, 2026 09:54
@tieuanhquoc tieuanhquoc mentioned this pull request Oct 7, 2026
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