From c7758a9411c9e0781c2acd84a16201f2b4b3e0e2 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 1 Jun 2026 07:43:10 +0000 Subject: [PATCH] docs: add training overrides section to authoring-schemas Adds a collapsed "Advanced training overrides" accordion documenting the four active (non-deprecated) fields in the `training:` block of model.yaml: max_parallel_methods, boundary_low, boundary_high, boundary_mode. Driven by 2026-06-01 police sweep (public-surface axis): the training section of model.schema.json had four active fields with no docs page coverage. All deprecated fields remain undocumented by design (users should use top-level `effort` instead). Monorepo sweep range: 390003a..HEAD https://claude.ai/code/session_0121FpspsLP2EgoL45uZSGgN --- api-reference/authoring-schemas.mdx | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/api-reference/authoring-schemas.mdx b/api-reference/authoring-schemas.mdx index de82c0d..2336afa 100644 --- a/api-reference/authoring-schemas.mdx +++ b/api-reference/authoring-schemas.mdx @@ -65,6 +65,23 @@ sources: clarity: { trait: clarity } ``` +### Advanced training overrides + +The optional `training:` block exposes host-level knobs that `effort` does not control. Most models do not need this section. + + + +| Field | Type | Default | Purpose | +|-------|------|---------|---------| +| `max_parallel_methods` | integer ≥ 1 | 4 | Concurrent method studies during Optuna optimization. Tune to host concurrency. | +| `boundary_low` | number 0–50 | — | Fixed low percentile boundary. When set with `boundary_high`, skips the boundary sweep. | +| `boundary_high` | number 50–100 | — | Fixed high percentile boundary. Pair with `boundary_low`. | +| `boundary_mode` | `exclude` \| `interpolate` | `exclude` | How samples between the fixed boundaries are handled. Only used when `boundary_low`/`boundary_high` are set. | + +All other `training:` fields are deprecated — use the top-level `effort` field instead. + + + ### Sources A source supplies training samples. Each entry has a `type`; the remaining fields depend on it.