Skip to content

docs: add doc comments to IClusteringModel and related types (#97)#100

Merged
martinjms merged 1 commit intoepic/test-doc-passfrom
feat/issue-97-add-doc-comments-to-iclusteringmodel-and
May 2, 2026
Merged

docs: add doc comments to IClusteringModel and related types (#97)#100
martinjms merged 1 commit intoepic/test-doc-passfrom
feat/issue-97-add-doc-comments-to-iclusteringmodel-and

Conversation

@martinjms
Copy link
Copy Markdown
Contributor

Summary

Add missing /// doc comments to all public types and their fields in crates/arcane-core/src/clustering_model.rs — the IClusteringModel trait and its associated data types.

Decisions made

None — work was a literal implementation of the issue spec. Every field comment describes what the field represents, sourced from the architecture doc (IF-01) and the existing code.

Test plan

  • Builds clean (cargo build -p arcane-core)
  • Tests pass (cargo test -p arcane-core)
  • Format clean (cargo fmt --all -- --check)
  • Doc generation free of new warnings (cargo doc --no-deps -p arcane-core)

Refs #97

Adds /// doc comments to all public types and their fields in
crates/arcane-core/src/clustering_model.rs: WorldStateView,
ClusterInfo, PlayerInfo, ClusterDecision, DecisionType,
DecisionReason, ModelInfo, and ValidationResult.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@martinjms martinjms marked this pull request as ready for review May 2, 2026 13:41
@martinjms martinjms merged commit 3c936d2 into epic/test-doc-pass May 2, 2026
1 check passed
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