Skip to content

Docs: runnable model tasks and verified book links - #53

Merged
stefan-jansen merged 6 commits into
mainfrom
docs/task-guides-book-links
Oct 18, 2026
Merged

stefan-jansen merged 6 commits into
mainfrom
docs/task-guides-book-links

Conversation

@stefan-jansen

@stefan-jansen stefan-jansen commented Sep 24, 2026 •

Copy link
Copy Markdown
Contributor

A reader can run a bounded PCA forecast from the README or Quickstart using the base wheel, verify finite output with shape (2, 6), and follow task guides to generated API signatures and pinned public teaching files. Seven runnable examples cover factor forecasting, SDF, direct asset prediction, portfolio learning and downstream handoffs.

Closes #52.

Document optional dependencies and training limits explicitly. Distinguish book notebooks that teach related methods from the case-study bridge that calls ml4t.models. All ten linked files exist at companion revision d2edec54b1c7a6a9d7a97d8129eb05db4491e1eb.

Replace dense embedded diagrams with shared HTML that reflows with the article. At 375px and 1440px, figure and table labels measure 14.44px beside 15.2px prose, without figure or page overflow. A browser check rejects a real rebuilt stylesheet regression producing 30.4px labels and passes after restoring the intended stylesheet. The mobile navigation menu also works.

Local verification includes strict MkDocs, runnable examples from clean installed wheels outside the source checkout, rendered local links, Ruff, ty and native commit hooks. The combined candidate passes 466 source tests and 426 installed-wheel tests with NumPy-only and full optional-dependency environments. Book datasets and full research training are not rerun.

At 94d05ab against merged main 370b046, all 33 applicable hosted checks pass, including the source and installed-wheel platform matrices, dependency audit, Python 3.15 prerelease, strict documentation and MPS qualification. Two jobs skip under configured conditions, including the main-only CUDA/performance job.

AI assistance: Codex prepared, reviewed and verified the documentation changes. No documentation deployment or package release is performed by this PR.

Copilot AI lite review requested due to automatic review settings September 24, 2026 17:03

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@stefan-jansen
stefan-jansen merged commit f8ca0d8 into main Oct 18, 2026
35 checks passed
@stefan-jansen
stefan-jansen deleted the docs/task-guides-book-links branch October 18, 2026 02:48
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.

Improve task guidance, runnable examples, and pinned book links

2 participants