Skip to content

docs: decision oracle guide and API reference (@ixo/decision-oracle) - #52

Closed
youssefhany-ixo wants to merge 3 commits into
mainfrom
docs/decision-oracle
Closed

youssefhany-ixo wants to merge 3 commits into
mainfrom
docs/decision-oracle

Conversation

@youssefhany-ixo

@youssefhany-ixo youssefhany-ixo commented Oct 22, 2026 •

Copy link
Copy Markdown
Collaborator

Adds public pages for the @ixo/decision-oracle npm package. Its npm README links to docs inside a private repo, so partners hit 404s. These pages give them somewhere public to go.

What changes:

  • New page build-an-oracle/decision-oracle: the guide to building and running a decision oracle, from an empty directory to deployed, hired and signing on chain.
  • New page build-an-oracle/decision-oracle/api-reference: every export, config field, binding, var, HTTP route and CLI command.
  • A "Decision oracle" group in the Build an Oracle nav (docs.json), plus a card on the section's landing page.
  • Says plainly that the oracle can run on the free Cloudflare workers.dev address. A custom domain is optional.

Both pages come from the package's own guide.md and api.md. I removed internal notes (owner rulings, spec and session ids, private repo paths) and pointed cross-links at these pages.

Checks: eslint (mdx) passes on the new pages. markdownlint passes. mint broken-links reports nothing in these files (the 17 broken links it finds were already in other pages).

Order: merge this first, then release the package. The package PR sets npm's homepage to this page: https://github.com/ixoworld/eval-oracle/pull/239 (leave it open until the docs are live)

Also adds an "Easiest way: build it with your AI agent" section near the top of the guide, plus a line on the landing card, for the ixo-oracle-builder plugin from ixoworld/ixo-plugins. Merge together with ixoworld/ixo-plugins#49: that PR is where the plugin starts on testnet by default and uses workers.dev, as this page says.

Partner-facing pages for the @ixo/decision-oracle npm package (how to build and
run one, and the full API reference), taken from the package's guide.md and
api.md with internal notes removed. Adds a Decision oracle group to the Build an
Oracle nav and a card on its landing page. Notes that the oracle runs on a free
workers.dev address and a custom domain is optional.

Co-authored-by: Youssef Hany <youssef.hany@ixo.earth>
…nding page

Co-authored-by: Youssef Hany <youssef.hany@ixo.earth>
…der plugin

Co-authored-by: Youssef Hany <youssef.hany@ixo.earth>
@youssefhany-ixo

Copy link
Copy Markdown
Collaborator Author

Closing: docs.ixo.world is served from ixoworld/ixo-docs, so this moved to https://github.com/ixoworld/ixo-docs/pull/10.

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