WIP: Enforce Rust documentation policy across authored crate roots #402

Draft
erikinkinen wants to merge 5 commits from feature/rust-documentation-policy into feature/sha2-host-command-fixture
Owner

Adds the Rust documentation policy checker with Cargo-discovered crate roots, selected authored-body reads and attribute checks across inactive modules. Automatic tests, examples, benchmarks and build scripts must carry an unconditional missing-docs lint; conditional declarations and weakening attributes are rejected.

Repeated preparation requires an explicit choice before replacing generated CI metadata. The checker uses the existing Cargo and native process owners.

Depends on #395.

  • Port the complete checker, source reader and attribute parser.
  • Cover automatic roots, real compiler rejection, source substitutions and generated-state replacement.
  • Adopt the checker with a coherent default CI helper selection.
Adds the Rust documentation policy checker with Cargo-discovered crate roots, selected authored-body reads and attribute checks across inactive modules. Automatic tests, examples, benchmarks and build scripts must carry an unconditional missing-docs lint; conditional declarations and weakening attributes are rejected. Repeated preparation requires an explicit choice before replacing generated CI metadata. The checker uses the existing Cargo and native process owners. Depends on #395. - [x] Port the complete checker, source reader and attribute parser. - [x] Cover automatic roots, real compiler rejection, source substitutions and generated-state replacement. - [ ] Adopt the checker with a coherent default CI helper selection.
erikinkinen added this to the Alpha 1 milestone 2026-11-06 12:04:36 +01:00
feat: Enforce authored Rust documentation policy
Some checks failed
CI / rust (pull_request) Has been skipped
CI / host_zero (pull_request) Has been skipped
CI / host_one (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / integration (pull_request) Has been skipped
Coreutils provider graph / coreutils (pull_request) Has been skipped
CI / markdown (push) Successful in 12s
Coreutils provider graph / coreutils (push) Failing after 34s
CI / rust (push) Successful in 5m34s
CI / host_one (push) Failing after 15m18s
CI / host_zero (push) Failing after 19m18s
CI / integration (push) Has been skipped
0cf0f30f96
Discover automatic crate roots through selected Cargo metadata and inspect original authored attributes, including inactive modules. Require an explicit choice before replacing existing generated CI metadata.
test: Isolate native feature forwarding from runtime intake
Some checks failed
CI / rust (pull_request) Has been skipped
CI / host_zero (pull_request) Has been skipped
CI / host_one (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / integration (pull_request) Has been skipped
Coreutils provider graph / coreutils (pull_request) Has been skipped
CI / markdown (push) Successful in 15s
Coreutils provider graph / coreutils (push) Failing after 48s
CI / rust (push) Failing after 1m1s
CI / host_zero (push) Has been cancelled
CI / host_one (push) Has been cancelled
CI / integration (push) Has been cancelled
3f1e84b8ad
Observe the runtime selection passed to the shared-object builder without
starting an unrelated native source acquisition in the CLI forwarding test.
ci: Use shared development dependency profiles
Some checks failed
CI / rust (pull_request) Has been skipped
CI / host_zero (pull_request) Has been skipped
CI / host_one (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / integration (pull_request) Has been skipped
Coreutils provider graph / coreutils (pull_request) Has been skipped
CI / rust (push) Has been cancelled
CI / host_zero (push) Has been cancelled
CI / host_one (push) Has been cancelled
CI / integration (push) Has been cancelled
CI / markdown (push) Has been cancelled
Coreutils provider graph / coreutils (push) Has been cancelled
60a5dbfa50
Keep authored manifests on main and select coordinated providers through Integration. Resolve branches once per run, retain the frozen snapshot and helper identity as artifacts, and use shared source checks instead of copied tests and guides.
ci: Separate Markdown checks from the build workflow
Some checks failed
CI / rust (pull_request) Has been skipped
CI / host_zero (pull_request) Has been skipped
CI / host_one (pull_request) Has been skipped
CI / integration (pull_request) Has been skipped
Coreutils provider graph / coreutils (pull_request) Has been skipped
Markdown / markdown (pull_request) Has been skipped
CI / rust (push) Has been cancelled
CI / host_zero (push) Has been cancelled
CI / host_one (push) Has been cancelled
CI / integration (push) Has been cancelled
Coreutils provider graph / coreutils (push) Has been cancelled
Markdown / markdown (push) Has been cancelled
27f860a760
Keep each workflow below the repository size limit by giving Markdown its own file. Preserve event filters, job conditions and command bodies, with independent concurrency for the Markdown workflow.
ci: Use shared development dependency profiles
Some checks failed
Coreutils provider graph / coreutils (push) Failing after 45s
Markdown / markdown (push) Successful in 13s
CI / rust (push) Successful in 6m43s
CI / rust (pull_request) Has been skipped
CI / host_zero (pull_request) Has been skipped
CI / host_one (pull_request) Has been skipped
CI / integration (pull_request) Has been skipped
Coreutils provider graph / coreutils (pull_request) Has been skipped
Markdown / markdown (pull_request) Has been skipped
CI / host_one (push) Failing after 6m5s
CI / host_zero (push) Failing after 22m40s
CI / integration (push) Has been skipped
d191dd088c
Keep authored manifests on main and select coordinated providers through Integration. Resolve branches once per run, retain the frozen snapshot and helper identity as artifacts, and use shared source checks instead of copied tests and guides.
Some checks failed
Coreutils provider graph / coreutils (push) Failing after 45s
Markdown / markdown (push) Successful in 13s
CI / rust (push) Successful in 6m43s
CI / rust (pull_request) Has been skipped
CI / host_zero (pull_request) Has been skipped
CI / host_one (pull_request) Has been skipped
CI / integration (pull_request) Has been skipped
Coreutils provider graph / coreutils (pull_request) Has been skipped
Markdown / markdown (pull_request) Has been skipped
CI / host_one (push) Failing after 6m5s
CI / host_zero (push) Failing after 22m40s
CI / integration (push) Has been skipped
This pull request is marked as a work in progress.
This branch is out-of-date with the base branch
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin 'feature/rust-documentation-policy:feature/rust-documentation-policy'
git switch 'feature/rust-documentation-policy'

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch 'feature/sha2-host-command-fixture'
git merge --no-ff 'feature/rust-documentation-policy'
git switch 'feature/rust-documentation-policy'
git rebase 'feature/sha2-host-command-fixture'
git switch 'feature/sha2-host-command-fixture'
git merge --ff-only 'feature/rust-documentation-policy'
git switch 'feature/rust-documentation-policy'
git rebase 'feature/sha2-host-command-fixture'
git switch 'feature/sha2-host-command-fixture'
git merge --no-ff 'feature/rust-documentation-policy'
git switch 'feature/sha2-host-command-fixture'
git merge --squash 'feature/rust-documentation-policy'
git switch 'feature/sha2-host-command-fixture'
git merge --ff-only 'feature/rust-documentation-policy'
git switch 'feature/sha2-host-command-fixture'
git merge 'feature/rust-documentation-policy'
git push origin 'feature/sha2-host-command-fixture'
Sign in to join this conversation.
No description provided.