updated docs; minor judgerubric tweak for optional state arg

[willccbb]

Description

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Test improvement

Testing

• All existing tests pass when running uv run pytest locally.
• New tests have been added to cover the changes

Checklist

• My code follows the style guidelines of this project as outlined in AGENTS.md
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• Any dependent changes have been merged and published

Additional Notes

---

Note

Major docs refresh and small rubric API improvements.

• Rubrics: New Rubric.add_metric() (weight=0 shorthand) and Rubric.add_class_object() helpers; RubricGroup forwards both
• JudgeRubric: judge(prompt, completion, answer, state=None)—state now optional; cache read/write guarded when state is absent
• Docs: Rewrites overview.md, environments.md, and development.md; adds faqs.md and placeholder evaluation.md; removes legacy docs/release/TRAJECTORIES.md, docs/source/components.md, and docs/source/concepts.md; updates .gitignore to ignore docs/source/old/

^{Written by Cursor Bugbot for commit 96f239a. This will update automatically on new commits. Configure here.}