Repository navigation
Conversation
…uides
Search visibility for the long-tail queries Broza's users actually type
("is it safe to delete xcode deriveddata", "docker.raw taking up space",
"what is system data on mac"), rather than head terms like "mac disk full"
that Apple and the commercial cleaners own.
Landing page:
- Title and description lead with the search intent and name the developer
caches.
- og:image (1200x630, 93 KB), summary_large_image, og:site_name.
- SoftwareApplication JSON-LD.
- Two h2s rephrased to carry the terms people search.
- Detector table ids link to their guide; nav and footer link the guides.
New:
- site/explain/: ten guides plus an index, one per query cluster. The
"What it is / What it is for / Is it safe" sections are copied verbatim
from category_text.rs, purpose.rs and the README; the page-specific
paragraphs restate docs/cli-spec.md §3.3 and add no new claims.
TechArticle + BreadcrumbList JSON-LD on each.
- robots.txt, sitemap.xml (12 URLs), 404.html (noindex, absolute paths so it
works at any depth).
README gains the searched-for terms in its first paragraph and a guides link;
AGENTS.md §11 records that the guides must follow the prose they copy.
No analytics or third-party requests: the site keeps the tool's
no-network promise.
Invariants touched: none.
- Docker.raw guide: drop the INFO ONLY badge. The spec rates docker-raw amber; inform-only is its action, not a red risk. - Cloud-synced guide: title down to 58 characters so results do not truncate it. - Landing page: hero pill and JSON-LD no longer hard-code a version, which had already drifted (pill said 1.0, release is 1.1.0). Invariants touched: none.
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
SEO pass aimed at the long-tail developer queries Broza can realistically win ("is it safe to delete xcode deriveddata", "docker.raw taking up space mac", "what is system data on mac"), not head terms like "mac disk full" that Apple Support and the commercial cleaners own.
Landing page
<title>and a 148-char description naming the developer caches.og:image1200×630 (93 KB),summary_large_image,og:site_name.SoftwareApplicationJSON-LD.<h2>s rephrased to carry searched terms; detector ids link to their guides.New pages
site/explain/— ten guides + index. Core sections copied verbatim fromcategory_text.rs,purpose.rsand the README; page-specific paragraphs restatedocs/cli-spec.md§3.3 without new claims.TechArticle+BreadcrumbListJSON-LD.robots.txt,sitemap.xml(12 URLs),404.html(noindex, absolute/broza/paths).Repo
node_modules, Docker, caches, snapshots; links the guides.No analytics, no third-party requests.
Test plan
href/srcon 13 pages resolves./broza/) checked in the browser pane; no console errors.robots.txt,sitemap.xmland every sitemap URL return 200./and one guide: no errors.og.png.Invariants touched
None.