santhoshj/astro-website
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

lighthouse fixes

Browse Source
This commit is contained in:
Santhosh Janardhanan
2026-02-10 22:37:29 -05:00
parent 26a8c97841
commit 07d8787972
785 changed files with 166486 additions and 77 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
openspec/specs/seo-content-surface/spec.md
View File

@@ -42,7 +42,7 @@ The site MUST provide Open Graph and Twitter card metadata for indexable pages s
### Requirement: Sitemap and robots
The site MUST provide:
- `sitemap.xml` enumerating indexable pages
- `sitemap-index.xml` enumerating indexable pages (and/or referencing sitemap shards)
- `robots.txt` that allows indexing of indexable pages
The sitemap MUST include the blog surface routes:
@@ -51,17 +51,32 @@ The sitemap MUST include the blog surface routes:
- blog page detail routes
- blog category listing routes
#### Scenario: Sitemap is available
- **WHEN** a crawler requests `/sitemap.xml`
- **THEN** the server returns an XML sitemap listing `/`, `/videos`, `/podcast`, `/about`, and `/blog`
`robots.txt` MUST reference the sitemap using an absolute URL for the production domain.
#### Scenario: Sitemap index is available
- **WHEN** a crawler requests `/sitemap-index.xml`
- **THEN** the server returns an XML sitemap index (or sitemap) listing `/`, `/videos`, `/podcast`, `/about`, and `/blog`
#### Scenario: Blog URLs appear in sitemap
- **WHEN** WordPress content is available in the cache at build time
- **THEN** the generated sitemap includes the blog detail URLs for those items
#### Scenario: Robots references sitemap with absolute URL
- **WHEN** a crawler requests `/robots.txt`
- **THEN** the response contains a `Sitemap:` line with an absolute URL to `/sitemap-index.xml`
### Requirement: Structured data
The site MUST support structured data (JSON-LD) for Video and Podcast content when detail pages exist, and MUST ensure the JSON-LD is valid JSON.
#### Scenario: Video structured data present
- **WHEN** a video detail page exists and is requested
- **THEN** the HTML includes JSON-LD describing the video using a recognized schema type
### Requirement: Organization and website structured data
The home page SHOULD include JSON-LD structured data for the site and its owner/organization.
If present, the JSON-LD MUST be valid JSON and MUST use a recognized schema type.
#### Scenario: Home page includes valid JSON-LD
- **WHEN** a crawler requests `/`
- **THEN** the HTML contains a JSON-LD script tag that parses as valid JSON