Skip to content

docs: headline the 1.17 pairs()/align ladder; demote dataset()/research() to legacy#126

Open
helloiamvu wants to merge 2 commits into
mainfrom
docs/readme-117-surface
Open

docs: headline the 1.17 pairs()/align ladder; demote dataset()/research() to legacy#126
helloiamvu wants to merge 2 commits into
mainfrom
docs/readme-117-surface

Conversation

@helloiamvu

Copy link
Copy Markdown
Member

Summary

Post-v1.17.0 docs refresh: the README still presented dataset() as the flagship "alignment engine" with research() as its alias — both became deprecation shims in 1.17.0. No code changes.

  • README: intro, quickstart, and "what you can build" now lead with weather.pairs() and the three-rung align ladder; markets examples use kalshi.pairs()/polymarket.pairs() (with outcome=True); the stale D-22 FutureWarning note (wrong since 34-06 cancelled the flip) is replaced with an accurate legacy note; docs index promotes the migration guide and marks docs/dataset.md as the legacy composer doc.
  • docs/dataset.md: legacy-surface banner pointing at the migration guide.
  • docs/ts-quickstart.md: TS-on-1.17 note — surface unchanged there, dataset() still emits the D-22 warning (accurately documented), ladder is Python-only (PT-3401).
  • Every Python snippet verified executable offline against the shipped 1.17 surface (stubbed at the dispatch/oracle boundary — the same seams the test suite uses).

Review

Codex loop (docs-with-code-fragments rule): round 1 found 2 CRITICAL + 1 HIGH (TS banner overclaimed vs shipped TS warning behavior; <event_id> placeholder failed _EVENT_ID_RE pre-network; @mostlyrightmd/core description claimed research()) — all fixed; round 2 PASS.

Found along the way (filed as separate tasks, not in this PR)

  • BYO spine without a date column crashes align(…, weather.obs(…)) with a raw pandas MergeError instead of a style-guide ContractError.
  • TS dataset() still promises the 2.0 label-default flip that Python cancelled — cross-SDK 2.0 parity risk.

🤖 Generated with Claude Code

helloiamvu and others added 2 commits July 15, 2026 10:06
…ch() to legacy

- README intro, quickstart, and 'what you can build' now lead with
  weather.pairs() + the three-rung align ladder (snippets verified
  executable offline against the shipped 1.17 surface); markets examples
  moved to kalshi/polymarket.pairs(); stale D-22 FutureWarning note
  removed (the flip was cancelled in 1.17); docs index promotes the
  migration guide and marks docs/dataset.md as the legacy composer doc.
- docs/dataset.md gets a legacy-surface banner; docs/ts-quickstart.md
  gets a TS-on-1.17 note (research()/dataset() current THERE, ladder
  Python-only, PT-3401).
- BYO-spine example documents the date join-key requirement (the
  raw-MergeError UX gap is filed separately).

No code changes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…holder, core-package description

Codex findings on 19c96cc: (1) the TS-on-1.17 banner overclaimed — TS
dataset() still emits the D-22 FutureWarning on omitted label (the Python
flip-cancellation was not ported; divergence filed separately); (2)
'<event_id>' fails _EVENT_ID_RE before any network call — placeholder is
now a regex-valid slug; (3) @mostlyrightmd/core does not export research()
(it lives in the mostlyright meta package).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@helloiamvu helloiamvu requested a review from Tarabcak July 15, 2026 08:13
@github-actions

Copy link
Copy Markdown

Parity ticket gate: PASSED

parity-ticket-check: PR does not touch parity-trigger surface; gate skipped.

See CROSS-SDK-SYNC.md §2 for the workflow.

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