Skip to content

docs: state the model requirements and how to reshape existing code in the existing model guide - #855

Draft
ivargr wants to merge 3 commits into
masterfrom
docs/existing-model-requirements
Draft

ivargr wants to merge 3 commits into
masterfrom
docs/existing-model-requirements

Conversation

@ivargr

@ivargr ivargr commented Nov 9, 2026

Copy link
Copy Markdown
Contributor

Summary

Follow-up to #830. The existing model guide described the target shape (two scripts, copy from the template) but not what Chap actually requires, and it assumed the reader's code was already split into train and predict. It now opens with the requirements in one place, gives recipes for mapping a messy or joint fit-and-forecast codebase onto train and predict (including a train script that does nothing, explained in plain words), shows a before-and-after example, and lists checks to run before chap eval. Packaging and publishing move to a new page shared with the template tutorial.

Review needed

Review needed: check: the requirements listed in part 1 of the guide are accurate and complete

Test plan

  • make docs builds in strict mode with the new page in the nav.
  • The three example scripts in the guide (lib.R, train.R, predict.R) were run with R in Docker against the template's input data and produce one forecast row per future row.
  • make lint passes.

…n the existing model guide

Add a section with what Chap needs from a model, recipes for mapping
messy or joint train-and-forecast code onto train and predict scripts,
a before-and-after example and checks to run before chap eval. Explain
that a train script may do nothing. Move packaging and publishing to a
page shared with the template tutorial.
… not know yet

Replace the what-you-do-not-need box with one sentence about Docker and
the Chap server, and move the chapkit notes to a collapsed section at
the end for readers who arrived from the chapkit documentation.

This branch has not been deployed

No deployments
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