Skip to content

seo: heavy pass — schema, descriptions, landing pages, keyword map - #18

Merged
bong-water-water-bong merged 1 commit into
mainfrom
seo/heavy-pass
Nov 3, 2026
Merged

bong-water-water-bong merged 1 commit into
mainfrom
seo/heavy-pass

Conversation

@bong-water-water-bong

Copy link
Copy Markdown
Contributor

Owner asked for a heavy SEO pass ("we need to get found"). This is the site side. Nothing in it says the release is published: the held release post stays draft: true (#15/#16), and the landing pages say only that the packages ship on the releases page "when a release has passed its checklist".

Audit (engine main + this repo's main; 51 pages before, 53 after)

page(s) issue fix
9 posts (first-week, hrx-prefill-vulkan, new-direction, qwen38-dflash2, speculative-decoding, npu-drafts, zyphra, hrx-long-prompts, this-week) meta description 95-139 chars, or cut mid-list summary: rewritten to 148-160 chars from each post's own numbers
one-gpu-many-users title 33 chars, no keyword title: One GPU, many users: Qwen3.8-27B batching
determinism, hetero-prefill no PAGE_META (heading + first paragraph used) PAGE_META added
arch-gaps, npu-leaderboard description 139 / 136 lengthened to 151 / 143
docs, architecture descriptions still name DwarfStar (removed 11-01) dropped
serve, hrx, hybrid titles without the searched term "OpenAI-compatible local LLM server", "(gfx1151)", "GPU decode on Strix Halo"
every page but home no BreadcrumbList added (Home > Docs > page, Home > Blog > post, Home > guide)
overview about: #software pointed at a node only on the home page SoftwareApplication + SoftwareSourceCode in its graph
home SoftwareApplication had no processor requirements / features; 0 H2 processorRequirements, featureList, softwareHelp; one H2
all doc pages 0 links to posts "Related posts" (newest posts sharing the doc's tags, DOC_TAGS)
all posts 0-2 links to docs "Related docs" + "More posts like this"
site no FAQ / FAQPage, no Strix Halo hub page site/pages/faq.md (12 Q&A, FAQPage JSON-LD), site/pages/strix-halo.md
feed.xml <updated> = publish date the post's last commit
site no llms.txt; no large-image preview directive llms.txt; robots meta max-image-preview:large, max-snippet:-1
os-v3, os-v3-live-puppy-eval truncated title / 116-char description left to #16, which already adds their PAGE_META
404 short title/description noindex, left as is
images all 5 <img> (README badges) have alt nothing to do
WebSite SearchAction the site has no search not added (it must point at a working search)

Sitemap: every indexable page, including the two new ones. One H1 per page holds (the build still stops otherwise).

Files

file why
tools/site.py breadcrumbs, FAQ extraction, SoftwareSourceCode, landing pages (site/pages), related links, llms.txt, feed <updated>, PAGE_META
site/pages/strix-halo.md, site/pages/faq.md landing pages; every number is already on models.md / hrx.md / npu.md / lemonade.md or a post, and linked there
site/style.css two small rules (home H2, related lists)
blog/*.md (10) summary: lines only, plus one title: line; no post body changed
SEO-KEYWORDS.md 14 query clusters mapped to primary/supporting pages, the gaps, the rules
SHARE-KIT.md per-community drafts (r/LocalLLaMA, r/StrixHalo, r/AMD, r/ROCm, r/linux, r/selfhosted, r/puppylinux HOLD, Show HN HOLD) for the owner to post by hand
README.md says what the new files are

Verified

ONEBIT_ENGINE_DIR=<engine main> python3 tools/site.py <out>   -> 53 pages (rc 0)
every page: 1 <h1>; JSON-LD parses; no duplicate descriptions
descriptions under 140: 404 (noindex) and os-v3-live-puppy-eval (#16) only
test merge with #16's branch                                  -> clean

#15 only adds the held post, so no overlap with it either.

🤖 Generated with Claude Code

- JSON-LD: BreadcrumbList on every page but home; SoftwareApplication gains
  processorRequirements, featureList and softwareHelp and rides on the overview,
  the docs index and the landing pages so their about @id resolves in-page;
  SoftwareSourceCode on home and overview; FAQPage from any
  "## Frequently asked questions" section; Organization sameAs adds the site
  repo and the Hugging Face org.
- Landing pages from site/pages/*.md: a Strix Halo guide and an FAQ, facts
  only from the engine docs and the posts; in the sidebar, docs index, home.
- Internal links: doc pages end with related posts, posts with related docs
  and posts (DOC_TAGS); bare page links in landing pages stay as written.
- Descriptions: nine post summaries brought to 140-160 characters, a search
  title for "One GPU, many users", PAGE_META for determinism and
  hetero-prefill, DwarfStar dropped from the docs/architecture descriptions,
  keyword titles for serve, hrx and hybrid.
- robots max-image-preview:large, llms.txt, feed entries carry their last
  commit as <updated>, an H2 on the home page.
- SEO-KEYWORDS.md (query clusters -> pages) and SHARE-KIT.md (drafts for the
  maintainer to post; nothing is posted from here).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@bong-water-water-bong
bong-water-water-bong merged commit e914e5b into main Nov 3, 2026
2 checks passed
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.

1 participant