Skip to content

Feat(docs)/seo optimization#102

Merged
andrewmelchor merged 2 commits intomainfrom
feat(docs)/seo-optimization
Mar 2, 2026
Merged

Feat(docs)/seo optimization#102
andrewmelchor merged 2 commits intomainfrom
feat(docs)/seo-optimization

Conversation

@andrewmelchor
Copy link
Copy Markdown
Member

Summary

  • SEO foundation improvements
  • Adds canonical site configuration and richer global metadata support (description, canonical URL, OG, Twitter, social image handling).
  • Expands homepage metadata with keyword-focused title/description and social-specific description copy.
  • Ensures homepage is prerendered so it is included in static SEO outputs.

@greptile-apps
Copy link
Copy Markdown

greptile-apps bot commented Mar 1, 2026

Greptile Summary

This PR implements solid SEO foundations for the t-req documentation site. It adds canonical URL configuration, comprehensive Open Graph and Twitter Card metadata, and enables prerendering for the homepage to ensure it's included in static outputs.

Key changes:

  • Configured canonical site URL in Astro config
  • Added global description and social media image tags to Starlight config
  • Enhanced Layout component with flexible SEO metadata props (description, OG tags, Twitter Cards, canonical URLs)
  • Optimized homepage with keyword-rich title and description, enabled prerendering
  • Created robots.txt to allow crawling

Issue found:

  • The robots.txt file references a sitemap file, but the sitemap integration is not installed or configured in the project. Without this integration, no sitemap will be generated, which could impact SEO and crawler discovery.

Confidence Score: 3/5

  • Safe to merge after fixing sitemap configuration
  • The SEO implementation is well-structured and the metadata logic is correct. However, the missing sitemap integration means the robots.txt references a non-existent resource, which should be fixed before merging to avoid 404s for search engine crawlers.
  • Pay attention to packages/webdocs/public/robots.txt - needs sitemap integration configured

Important Files Changed

Filename Overview
packages/webdocs/astro.config.mjs Added site URL, description, and social media meta tags for SEO
packages/webdocs/public/robots.txt New robots.txt created but references sitemap that won't be generated without the sitemap integration
packages/webdocs/src/layouts/Layout.astro Added comprehensive SEO metadata support including canonical URLs, Open Graph, and Twitter Cards
packages/webdocs/src/pages/index.astro Enabled prerendering and added SEO-optimized title/descriptions, renamed CSS class to avoid conflicts

Last reviewed commit: c3e775e

Copy link
Copy Markdown

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

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

4 files reviewed, 1 comment

Edit Code Review Agent Settings | Greptile

@andrewmelchor andrewmelchor merged commit 519bb77 into main Mar 2, 2026
2 checks passed
@andrewmelchor andrewmelchor deleted the feat(docs)/seo-optimization branch March 2, 2026 03:44
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