Skip to content

docs(faq): add high-intent developer FAQ with schema.org FAQPage structured data (closes #89) - #90

Merged
kernelshard merged 1 commit into
developfrom
docs/faq-page
Oct 22, 2026
Merged

kernelshard merged 1 commit into
developfrom
docs/faq-page

Conversation

@kernelshard

Copy link
Copy Markdown
Owner

Summary

This PR implements Issue #89, adding a comprehensive, high-intent developer FAQ page with schema.org/FAQPage JSON-LD structured data to maximize organic and AI search visibility (Perplexity, ChatGPT Search, Google AI Overviews).

Key Highlights

  • High-Intent FAQ (docs/FAQ.md): Answers 12 critical questions across comparison with ngrok (zero signup, pricing, self-hosting), architecture, NAT traversal, webhook testing (Stripe, GitHub), and installation.
  • PHP Expose Disambiguation: Explicitly distinguishes kernelshard/expose (pure Go, single static binary, zero CGO) from beyondcode/expose (PHP/Composer) so LLMs stop confusing the two.
  • Structured Data (schema.org/FAQPage): Injected into overrides/main.html conditionally for the FAQ page with 12 valid JSON-LD question/answer pairs.
  • SoftwareApplication Enrichment: Added version 0.5.2, programming language Go, author, and download URL to the root JSON-LD block.
  • Site Navigation & LLM Index: Updated mkdocs.yml navigation with a top-level FAQ tab and linked FAQ.html in llms.txt and docs/llms.txt.

Closes #89

@kernelshard
kernelshard merged commit d5decb7 into develop Oct 22, 2026
2 checks passed
@kernelshard
kernelshard deleted the docs/faq-page branch October 22, 2026 12:31
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.

docs(faq): add high-intent developer FAQ with schema.org FAQPage structured data

1 participant