Submit the sitemap and validate structured data in Search Console

[khajavi]

Status: all code work is merged and deployed. Everything that can be checked automatically has been verified against production. What remains needs Google Search Console access, so this is a one-person task rather than a code change.

Remaining work

Both items need Search Console property access for ziohttp.com:

• Verify ownership of ziohttp.com, then submit https://ziohttp.com/sitemap.xml under Indexing → Sitemaps
• Request indexing of https://ziohttp.com/ via URL Inspection

Optional, and needs no Search Console account:

• validator.schema.org on https://ziohttp.com/ — expect Organization, WebSite, SoftwareSourceCode and BreadcrumbList, no errors
• Rich Results Test — expect Breadcrumbs detected. The other three are not rich-result types, so their absence is the correct outcome, not a failure

Worth checking a few days after submission: the Pages report for indexing coverage, and Enhancements → Breadcrumbs, where roughly 73 valid items are expected.

Verified in production

Check	Result
robots.txt	200, advertises the sitemap, disallows /search
sitemap.xml	200, ~108 URLs, includes the category hub pages, excludes /blog and /markdown-page
/blog, /markdown-page	404
/examples/static-files	301 to /examples/serving-static-files
Entity graph	Organization, WebSite, SoftwareSourceCode on 108 pages
Breadcrumbs	BreadcrumbList on 106 pages; 73 carry a real trail (68 two-level, 5 three-level)
Duplicate titles	0
Duplicate descriptions	0
Generated config pages	no leaked front matter; anchors and links resolve, zero unresolved

Contributing changes

PR	Change
#4260	Name casing, unified description, canonical homepage, robots.txt, JSON-LD entity graph, sitemap metadata, template pages removed, generated config page fixes, doc link normalization
#4265	Category links so breadcrumbs form a full trail
#4266	onBrokenMarkdownLinks moved under markdown.hooks
#4267	Examples sidebar grouped; duplicated static files example removed
#4268	Duplicate titles and absent descriptions fixed

Known non-issues

• 33 pages emit a single-element breadcrumb. These are root documents, category link targets, and the generated index pages themselves, all of which sit at the top of their own trail.
• /search and /algolia have no meta description. The former is already noindex; the latter is a helper page.
• lastmod is set on only one sitemap URL, so the lastmod: 'date' option is effectively inert. Docusaurus builds the mdoc output in website/docs, which is generated and gitignored, so the sitemap plugin has no git history to derive dates from. Harmless as it stands; making it work would require a custom sitemap step.

Not addressed

• The Organization node describes ZIO at zio.dev as the site's publisher, so logo signals accrue to zio.dev rather than ziohttp.com. Correct modelling, but worth revisiting if a knowledge panel for ziohttp.com is wanted.
• Eight guide titles exceed 60 characters and will be truncated in search results.

[khajavi]

The site has been deployed, so the checks that can be automated have now been run against production. All pass.

Check	Result
https://ziohttp.com/robots.txt	200, advertises https://ziohttp.com/sitemap.xml, disallows /search
https://ziohttp.com/sitemap.xml	200, 101 URLs, includes the 7 /category/... hub pages, contains neither /blog nor /markdown-page
/blog and /markdown-page	both 404
Homepage JSON-LD	Organization (zio.dev/#organization), WebSite (ziohttp.com/#website), SoftwareSourceCode (ziohttp.com/#software)
Breadcrumb on /guides/digest-authentication	Authentication > Digest Authentication (from #4265)
/reference/configs/server	no leaked front matter; 26 heading anchors, 26 links, zero unresolved

Still outstanding, since both need Search Console property access:

• Submit https://ziohttp.com/sitemap.xml in Google Search Console and request reindexing of /
• Run validator.schema.org and the Rich Results Test against https://ziohttp.com/

One new finding worth recording. lastmod is set on only 1 of 101 sitemap URLs, so the lastmod: 'date' option added in #4260 is effectively inert. The cause is structural: Docusaurus builds the mdoc output in website/docs, which is generated and gitignored, so the sitemap plugin has no git history to derive modification dates from. Making this work would mean deriving dates from the source files under docs/ instead, which the plugin has no way to do on its own. Not worth chasing unless someone wants to write a custom sitemap step; the option is harmless as it stands.