Repository navigation
SEO: written guides on the first ten template pages - #28
Merged
Merged
Conversation
Template pages were ~450-570 words of component lists. Ten now carry a guide written against the template's own diagram: how the architecture works, request flows step by step, key design decisions, how it scales and three searched-for questions (also as FAQPage JSON-LD). ChatGPT, Netflix, Uber ride-sharing, Instagram, video streaming, URL shortener, e-commerce, chat system, microservices, event-driven. ChatGPT page: 572 -> 1,227 words. guides.test.ts checks each guide belongs to a template, is complete and names most of that template's components.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
Important
This repository does not receive automatic reviews because it has fewer than 10 stars.
 |
This was referenced Nov 7, 2026
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Template pages target "X architecture diagram" searches, but they held only a diagram plus component and connection lists, about 450–570 words. The pages that rank for these searches are long walkthroughs.
Ten templates now carry a written guide (
data/templates/guides.ts), rendered bycomponents/landing/templates/TemplateGuide.tsxunder the diagram:FAQPageJSON-LDTemplates covered: ChatGPT, Netflix, Uber ride-sharing, Instagram, video streaming, URL shortener, e-commerce, chat system, microservices, event-driven. The ChatGPT page goes from 572 to 1,227 words, Netflix to 1,140 and URL shortener to 808. Templates without a guide are unchanged.
Real products are described from public information only, and the page already says the design is representative.
Test plan
guides.test.ts: each guide belongs to a real template, has every section and names most of that template's componentstscand eslint cleanFAQPageJSON-LD present/templates/chatgptwith Google's Rich Results Test