Skip to content

docs: tighten the SEO tags, name the head term, and add breadcrumbs and crawl links - #10

Merged
simien merged 1 commit into
mainfrom
docs/seo-pass
Sep 13, 2026
Merged

simien merged 1 commit into
mainfrom
docs/seo-pass

Conversation

@simien

@simien simien commented Sep 13, 2026

Copy link
Copy Markdown
Owner

What does this change?

A pass over the guide and the three explainers, checked against the app and against what a search result actually shows.

  • Two tags ran long. The seamless page's title was 72 characters (results cut around 60) and the animated page's description was 180 (cut around 155). Both are shortened on every copy: <title>, Open Graph, Twitter, and JSON-LD.
  • "Background generator" appeared on none of the explainers. It is the head term in the app's title. Each explainer now calls Flield "a seamless background generator" once, in the sentence that introduces it, and the try-it line says "free with no signup".
  • Breadcrumbs. The guide had a BreadcrumbList; the three explainers now have one each.
  • Crawl links from the home page. The app footer only linked the guide, so the explainers were two clicks deep. A line under the app's existing hidden description now links all three, with tabindex="-1" so keyboard users don't land on something invisible. Screen readers still find them in browse mode.
  • Guide heading. "Using Flield" becomes "Using Flield: looping motion, tiling, and locks", matching the title's keywords.
  • The 8192 cap is documented, under the guide's Sliders section. The width and height fields also snap to it on change; before, a typed 10000 rendered at 8192 but the field kept saying 10000 until a link or slot reloaded it.

Every factual claim on the four pages was checked against the code first (ranges, caps, defaults, locks, texture renames, presets, tutorial steps). All matched, so nothing else changed.

Related issue

None.

How was this tested?

  • python3 .github/scripts/checks.py main passes; every JSON-LD block parses.
  • In the browser on the branch: typing 10000 into width and leaving the field snaps it to 8192 with the canvas at 8192; the three crawl links are present with tabindex="-1"; the guide shows the new heading and the cap sentence; the seamless page shows the new title, both structured-data blocks, and the reworded intro and try-it lines.
  • Readability stats after the change are unchanged from before: 12.7 to 15.5 words per sentence across the four pages, no semicolons in prose.

Checklist

  • No new build step, package manager, framework, or CDN dependency introduced
  • generator.js still has no dependency on the UI, if touched (not touched)
  • Tested locally in at least one browser

🤖 Generated with Claude Code

…nd crawl links

A pass over the four document pages against the app and against what a
search result shows.

The seamless page's title was 72 characters and the animated page's
description 180; results cut around 60 and 155, so both lost their
endings. Shortened, on every copy of each.

"Background generator" is the head term in the app's title and appeared
on none of the explainers. Each now names Flield as a seamless
background generator once, in the sentence that introduces it, and its
try-it line says it is free with no signup.

The guide carried a BreadcrumbList and the explainers did not. Each has
one now. The app's footer only ever linked the guide, which left the
explainers two clicks from the home page; a crawlable line under the
existing hidden description links all three, out of the tab order.

The guide's heading was "Using Flield" under a title that carried the
keywords; the heading carries them now. It also says that width and
height stop at 8192, which the app has done since 509a42f, and the size
fields snap to that cap on change rather than showing a number the
canvas is not.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 13, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
flield 9dfaeba Commit Preview URL

Branch Preview URL
Sep 13 2026, 09:55 PM

@simien
simien merged commit b4cd278 into main Sep 13, 2026
2 checks passed
@simien
simien deleted the docs/seo-pass branch September 13, 2026 22:11
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