site: OpenAPI matches production; About gains the results section - #168
Merged
Merged
Conversation
The OpenAPI document advertised the retired server URL (interscript.org/api) and documented a GET form the live API does not implement. Now: server https://api.interscript.org/v1, POST-only /transliterate, and the missing /infer (neural models) and /info endpoints - every path verified against production before documenting. About gains a 'What the measurements show' section in plain user language: the benchmark outcome for our Arabic model, the frontier- model comparison (including the one figure we could not reproduce, stated as such), the browser-size model, and a link to the full tables on /ml.
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
1 participant
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.
What
OpenAPI corrected to match production — every path re-verified against the live API before documenting:
interscript.org/api→https://api.interscript.org/v1/transliterateremoved (production answers POST only; GET returns an unrelated GraphQL-style error)/infer(neural models —{"model","input"}→ output) and/info(version + catalogue counts)About page gains "What the measurements show" — the results story in plain user language: the Arabic benchmark result, the comparison against general-purpose models (the one unreproducible vendor figure disclosed as such), the newest-model regression, the browser-size model, and a link to the full tables on
/ml.Verification
Astro build clean; the built
openapi.jsoninspected: correct server, six paths, no GET on/transliterate. Live API probes for/transliterate(POST),/infer,/infoall confirmed before documenting.