Skip to content

feat: markdown cut, canonical resume.json, llms.txt, link-preview metadata - #11

Merged
JayTeeBat merged 1 commit into
mainfrom
feat/discoverable-formats
Jul 18, 2026
Merged

feat: markdown cut, canonical resume.json, llms.txt, link-preview metadata#11
JayTeeBat merged 1 commit into
mainfrom
feat/discoverable-formats

Conversation

@JayTeeBat

@JayTeeBat JayTeeBat commented Jul 18, 2026

Copy link
Copy Markdown
Owner

Four discoverability features for the published page:

  • Markdown joins pdf/html/json as a build format: the paste-ready cut for ATS forms, plain-text email and LLM prompts. template.md.j2 restates the theme opinion in Markdown, rendered without autoescape so & stays &, with the same colophon provenance line at the foot.
  • /resume.json: the guessable canonical machine address, a byte-identical alias of the primary published cut, so the URL survives renaming the variant behind it.
  • /llms.txt: the note an AI agent reads first, steering it to the canonical JSON instead of scraping the styled page.
  • index.html head grows OpenGraph/Twitter tags (what a pasted link looks like on LinkedIn and messengers), a canonical link, and a schema.org Person JSON-LD block (what search engines index), serialized in Python because autoescape would mangle it.

Site tests cover the new artifacts under the same publish/no-leak rules; render and build tests pin the Markdown cut to the same variant-conformity bar as the JSON.

…adata

Four discoverability features for the published page:

- Markdown joins pdf/html/json as a build format: the paste-ready cut for
  ATS forms, plain-text email and LLM prompts. template.md.j2 restates the
  theme opinion in Markdown, rendered without autoescape so & stays &,
  with the same colophon provenance line at the foot.
- /resume.json: the guessable canonical machine address, a byte-identical
  alias of the primary published cut, so the URL survives renaming the
  variant behind it.
- /llms.txt: the note an AI agent reads first, steering it to the
  canonical JSON instead of scraping the styled page.
- index.html head grows OpenGraph/Twitter tags (what a pasted link looks
  like on LinkedIn and messengers), a canonical link, and a schema.org
  Person JSON-LD block (what search engines index), serialized in Python
  because autoescape would mangle it.

Site tests cover the new artifacts under the same publish/no-leak rules;
render and build tests pin the Markdown cut to the same variant-conformity
bar as the JSON.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@JayTeeBat JayTeeBat changed the title feat: markdown cut, canonical resume.json, llms.txt, link-preview met… feat: markdown cut, canonical resume.json, llms.txt, link-preview metadata Jul 18, 2026
@JayTeeBat
JayTeeBat merged commit ad36d59 into main Jul 18, 2026
4 checks passed
@JayTeeBat
JayTeeBat deleted the feat/discoverable-formats branch July 18, 2026 23:31
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