Public blog markdown
Why public docs need owned raw routes
Public content actions break down if they depend on private GitHub raw links or third-party fetch assumptions.
# Why public docs need owned raw routes
Public docs are not just pages for people to read in a browser.
They also become inputs for:
- copy-and-share flows
- grounded retrieval
- AI handoff actions
- export and archival workflows
That only works cleanly if the raw content lives behind routes we control.
## The problem with private-repo assumptions
If public pages depend on GitHub raw URLs from a private repository, the
experience breaks immediately for anyone outside the repo boundary.
Even when the page itself is public, the supposed "raw" source becomes a dead
end.
## The stronger posture
The stronger posture is simple:
- public page
- public raw route
- one owner-controlled origin
That keeps copy, export, and AI handoff behavior inside the real public
contract instead of leaking private authoring assumptions into the surface.
## Why this matters for AI too
Third-party AI tools do not all fetch public URLs the same way. Some are
blocked by crawler rules, some refuse raw-file fetches, and some truncate
context.
Owned raw routes do not solve every AI problem, but they give us a stable
public source that our own systems and users can rely on.