Repository navigation
docs(deploy): connect the evaluation guide to the Policies & Decisions docs - #41
Merged
Merged
Conversation
…s docs evaluate.md §5.1 becomes "Design your policy": a what-to-read table (applications + decision matrix, template catalog, first policy, authoring, MCP co-design) and the policy rules that matter for an evaluation (fixed schema, samples, 26-option limit, depends_on costs a second pass). §5.4 maps error patterns to fixes (option rewording, taxonomy discovery, Stage 2 cascade - needs a GCP project for Gemini on Vertex AI, samples). Next links the full policy docs. first-policy.md and datasets.md link back to the evaluation guide.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Follow-up to #40: the evaluation guide only linked the policy docs in one sentence.
docs/deploy/evaluate.md§5.1 Design your policy (was "Write a policy"): a "what to read" table:
decide_custom_questions)It also lists the policy rules that matter for an evaluation: fixed schema with per-row
state,samples: 1, the 26-option limit,depends_on/ask_ifcosting a second pass, and evaluating the policy you will ship.§5.4: maps each error pattern to its fix:
cmd/cascade_gemini.go).samples: 4Run the test set once with the final policy and any cascade enabled.
Step 5 label in the overview table updated; Next links the full Policies & Decisions set.
Link-backs
policies/first-policy.md"Where to go next" → evaluation guide.policies/datasets.mdintro: callout for self-hosters to verify the install first, and to use a local gateway with the runners.Checks
make docs-sync-check(44/44),docs_link_check.py(0 broken) andmake check-publicpass. The docs-site build passes (45 pages), and all 11 in-page anchors on the three changed pages resolve in the built HTML.