Site Quality Remediation Log

Owner: Documentation Engineering
Requested by: Abhay Gawade review thread

This page tracks each reported issue, the implementation status, and the exact remediation completed in this repository.

Issue Tracker

ID	Issue	Severity	Status
1	404 URLs included in sitemap	Critical	✅ Fixed
2	Redirect source URLs included in sitemap	Minor	✅ Fixed
3	Broken Cloudflare email-protection links (/cdn-cgi/l/email-protection#...)	Critical	✅ Fixed
4	Broken hash/fragment anchors	Major	✅ Fixed
5	Missing meta descriptions in sampled pages	Major	✅ Fixed (canonical pages)
6	Missing canonical tags in sampled pages	Major	✅ Fixed (validated)
7	Missing robots meta tags	Minor	✅ Fixed
8	Missing hreflang tags	Conditional	✅ Fixed (canonical pages)
9	http:// references present in rendered content	Minor	✅ Fixed
10	Limited non-JS crawl discovery from homepage	Informational	✅ Fixed

Completed Remediation

1) 404 URLs removed from sitemap

• Removed non-crawlable routes from sitemap generation:
  • /404
  • /search
  • /markdown-page
  • /load-testing
  • /compute
• Implemented in runtime sitemap generator and build-time sitemap config.

2) Redirect-source URLs removed from sitemap

• Removed redirect-origin URLs from sitemap so only canonical final destinations are listed.
• Excluded roots include:
  • /gateway
  • /pipes
  • /streams
  • /monitor
  • /storage
  • /tables
  • /sdk
  • /references
  • /monitor/synthetic-monitoring/introduction

Sitemap URL normalization

• Normalized sitemap URLs to non-trailing-slash form for consistency (root remains /).
• Added sitemap item deduplication to avoid duplicate canonical entries.

3) Cloudflare email-protection dead links remediated

• Replaced support email mailto: links with https://www.boltic.io/contact-us across docs pages.
• Removed plain support-email strings from user-facing support sections to avoid Cloudflare email obfuscation path rewrites.
• Added fallback handling for /cdn-cgi/l/email-protection:
  • Runtime redirect in server route.
  • Static page fallback at /cdn-cgi/l/email-protection for static-hosted builds.

4) Broken path/hash links repaired and guarded

• Fixed invalid path reference in integrations docs:
  • ../concepts/advanced_options.md replaced with /workflow/advanced_options
• Added explicit anchor compatibility for existing deep links:
  • #boltic-sdk
  • #filtering-encrypted-columns
• Added regression test script: npm run test:internal-links-and-anchors
  • Validates internal path targets and #fragment targets against generated HTML in build/.

5-8) SEO head tags hardened and validated

• Added explicit homepage description metadata via Layout description.
• Added global robots meta tag (index,follow) in site theme config.
• Confirmed canonical tags are emitted on all generated canonical pages.
• Added regression test script: npm run test:seo-head-tags
  • Verifies description, canonical, robots, and hreflang tags.
  • Excludes known redirect/utility routes that are intentionally non-canonical and excluded from sitemap.

9) HTTP reference hygiene cleanup

• Replaced non-localhost http:// documentation links with https:// where applicable.
• Corrected malformed example anchor in scripted-browser docs.
• Added regression test script: npm run test:http-link-hygiene
  • Allows local development references (localhost, 127.0.0.1, placeholders).
  • Fails on unintended non-localhost http:// URLs.

10) Crawl/discovery improvements for non-JS tools

• Homepage service cards now render crawlable anchor href links (instead of click-only JS navigation).
• Added internal sitemap link in footer (/sitemap.xml) so basic crawlers can discover full inventory.
• Added static/robots.txt with explicit sitemap declaration.