Skip to content

feat: publish the specification as a site - #2

Draft
mikhailak wants to merge 1 commit into
mainfrom
feat/spec-site
Draft

feat: publish the specification as a site#2
mikhailak wants to merge 1 commit into
mainfrom
feat/spec-site

Conversation

@mikhailak

Copy link
Copy Markdown
Collaborator

Renders the spec repo with Jekyll and serves it from Pages, so TORPC has a neutral home instead of living inside vendor docs.

Needs one settings change from an admin: Pages source = GitHub Actions. I have maintain, not admin.

TORPC is meant to be implemented by anyone, but the only readable version of
it today is either a repository of markdown files or a page inside one
vendor's product documentation. Both are the wrong shape for a specification
another provider is supposed to adopt.

This renders the repository with Jekyll and serves it from GitHub Pages, so
the canonical home is a neutral URL. The specification itself does not move:
index.md is a front door that links to the documents, and jekyll-relative-links
keeps the in-repo markdown links working on the site.

The landing page states plainly that the conformance suite holds one case and
that no implementation, ours included, may call itself conformant yet.

The quickstart on it was executed against production while writing: the keyless
Monad endpoint answers with token-tier: 2 and a decimal, renamed body.

Enabling Pages on this repository is a settings change that needs admin.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@mikhailak
mikhailak requested a review from a team as a code owner August 25, 2026 07:28
@codacy-production

Copy link
Copy Markdown

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.

@mikhailak
mikhailak marked this pull request as draft August 26, 2026 11:06
@mikhailak

Copy link
Copy Markdown
Collaborator Author

Paused, not rejected: a site for the specification is not something we want right now. Left as a draft so it does not get merged by accident. Reopen for review if that changes.

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