Skip to content

Document 0.7 contract annotations (Phase 4.1) - #904

Closed
Gudge (MGudgin) wants to merge 1 commit into
mainfrom
user/gudge/v07-contract-rustdoc
Closed

Document 0.7 contract annotations (Phase 4.1)#904
Gudge (MGudgin) wants to merge 1 commit into
mainfrom
user/gudge/v07-contract-rustdoc

Conversation

@MGudgin

@MGudgin Gudge (MGudgin) commented Aug 14, 2026

Copy link
Copy Markdown
Member

📖 Description

Document 0.7 contract annotations

This PR documents the annotation fields exposed by the published 0.7.0-alpha configuration contract.

Details

  • Document the optional $schema editor-validation reference.
  • Document the ignored _comment annotation value.
  • Make the contract crate pass a strict missing_docs rustdoc build.

🔗 References

🔍 Validation

Tests

  • cargo fmt --all -- --check
  • $env:RUSTDOCFLAGS='-D missing-docs'; cargo doc -p mxc_config_contract --no-deps
  • cargo test -p mxc_config_contract (175 tests passed)
  • cargo clippy -p mxc_config_contract --all-targets -- -D warnings
  • git diff --check

✅ Checklist

📋 Issue Type

  • Bug fix
  • Feature
  • Task

This PR documents the annotation fields exposed by the published 0.7 configuration contract.

Details

* Document the optional `$schema` editor-validation reference.
* Document the ignored `_comment` annotation value.

Tests

* `cargo fmt --all -- --check`
* `$env:RUSTDOCFLAGS='-D missing-docs'; cargo doc -p mxc_config_contract --no-deps`
* `cargo test -p mxc_config_contract` (175 tests passed)
* `cargo clippy -p mxc_config_contract --all-targets -- -D warnings`

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings August 14, 2026 19:31
@MGudgin
Gudge (MGudgin) requested a review from a team as a code owner August 14, 2026 19:31
@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documents the published 0.7.0-alpha annotation fields and completes strict rustdoc coverage.

Changes:

  • Documents $schema as an editor-validation reference.
  • Documents _comment as runtime-ignored metadata.
Show a summary per file
File Description
src/core/mxc_config_contract/src/published/v0_7_0_alpha/request.rs Adds rustdoc for both annotation fields.

Review details

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

  • Files reviewed: 1/1 changed files
  • Comments generated: 0
  • Review effort level: Balanced

@MGudgin

Copy link
Copy Markdown
Member Author

Superseded by #907 after renaming the head branch to user/gudge/version_specific_config_parsers_phase4_1.

@MGudgin
Gudge (MGudgin) deleted the user/gudge/v07-contract-rustdoc branch August 14, 2026 19:42
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.

2 participants