Skip to content

Make the site findable, and attributable to its author - #23

Open
224Sand wants to merge 2 commits into
mainfrom
feat/seo
Open

Make the site findable, and attributable to its author#23
224Sand wants to merge 2 commits into
mainfrom
feat/seo

Conversation

@224Sand

@224Sand 224Sand commented Sep 6, 2026

Copy link
Copy Markdown
Owner

The site had no sitemap, no robots.txt, no canonical, and no structured data. The one that mattered most: it never said who built it, so a search for the author's name could not surface it however good the work was.

  • sitemap.ts — explicit route list, not a glob. A sitemap that silently gains pages is one nobody reviews.
  • robots.ts — allows everything except /api/, which is live agent state rather than content.
  • StructuredData.tsx — a Person entity (jobTitle, location, knowsAbout, sameAs → GitHub + LinkedIn) plus WebSite, SoftwareSourceCode for SandScope and SoftwareApplication for Charter, cross-referenced by @id. Answer engines cite structured entities rather than parsing prose.
  • metadataBase, a title template, and explicit author/creator/publisher.

Verified against a production build: robots.txt and sitemap.xml render, the JSON-LD parses to four typed entities, and the author's name now appears in the markup.

The site had no sitemap, no robots.txt, no canonical, no structured data,
and -- the one that mattered most -- never stated who built it. A search
for the author's name could not surface this site however good the work
was, because the name appeared nowhere in the markup.

Adds:

- sitemap.ts over an explicit route list. Globbing a directory would mean
  the sitemap silently gains pages nobody reviewed.
- robots.ts allowing everything except /api/, which is live agent state
  rather than content and costs crawl quota on both sides.
- StructuredData: a Person entity with jobTitle, location, knowsAbout and
  sameAs links to GitHub and LinkedIn, plus WebSite, SoftwareSourceCode
  (SandScope) and SoftwareApplication (Charter), all cross-referenced by
  @id. Answer engines increasingly cite structured entities rather than
  parsing prose; an unstructured page is one they can read but not
  attribute.
- metadataBase so OG and canonical URLs resolve absolutely, a title
  template so no page is anonymous in a results list, and explicit
  author/creator/publisher.
@vercel

vercel Bot commented Sep 6, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
sandscope Ready Ready Preview Sep 6, 2026 12:41pm UTC
sandscope-web Ready Ready Preview Sep 6, 2026 12:41pm UTC

The structured data added in this branch tells a crawler who built this.
It does not tell a reader, and a machine-readable entity with no visible
counterpart is the weaker half of the signal: crawlable links are what
actually consolidate a person, a site and a set of repositories into one
entity rather than three unrelated things.

Adds a site-wide footer naming the author with rel="me author" links to
GitHub and LinkedIn, plus source and Charter. Uses the existing .row-links
class, so the inline-style ratchet holds at 148.
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