Skip to content

seo: optimize /docs/research for CTR (title, meta, FAQ, internal links) - #109

Closed
philip638 wants to merge 1 commit into
pilot-protocol:mainfrom
philip638:seo/optimize-docs-research-v2
Closed

philip638 wants to merge 1 commit into
pilot-protocol:mainfrom
philip638:seo/optimize-docs-research-v2

Conversation

@philip638

Copy link
Copy Markdown
Contributor

CTR harvest — /docs/research

Before metrics (Search Console): 583 impressions, 1 click, avg position 16.3. Page ranks but the snippet isn't earning clicks.

Changes

  • Rewrote title/meta description to front-load the primary query and state the concrete deliverable (whitepaper, IETF drafts, papers) without touching the URL/slug.
  • Improved the H1 subtitle to answer the query directly.
  • Added a 4-item FAQ block (with FAQPage JSON-LD) covering the whitepaper, protocol comparison, IETF drafts, and the social-structures paper — feeds AI Overviews.
  • Added 2 contextual internal links from the "Further reading" callout to related posts (sociology-of-machines, AI networking terminology) and to Core Concepts.
  • Regenerated the corresponding plain-text page (src/pages/plain/docs/research.astro) to match.

No body/substance rewrite — this is a targeted snippet-and-structure pass. All factual claims unchanged.

npm run build and npm run check:plain both pass.

Signed-off-by: philip638 <philip638@users.noreply.github.com>
@TeoSlayer

Copy link
Copy Markdown
Contributor

Closing as stale: opened in early July, the page has changed since and this branch now conflicts with main. If the SEO change is still wanted, it is easier to redo against the current page (and its plain-text twin) than to rebase.

@TeoSlayer TeoSlayer closed this Oct 1, 2026
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.

2 participants