Replace placeholder examples with tested snippets and link all programs.
Generate completeness reports and fix broken links/warnings.
Validation
cargo doc --workspace --no-deps is warning-free.
Every mapped public item has useful docs and a C# concept/source link where appropriate.
All documentation snippets and quick-start workflows are tested.
Prerequisite
All implementation and program milestones are complete with their fixed parity suites green.
Project constraints
The released implementation is entirely native Rust and must pass the explicit no-CLR/no-bridge artifact audit.
Do not weaken API coverage or semantic parity to satisfy hardening, performance, or packaging goals.
Preserve reproducible evidence, update release documentation, and keep all default/live destructive boundaries explicit.
## Objective
Produce publishable documentation for every public crate/item and a practical C# to Rust migration guide.
## Deliverables
- Document crate selection/features, naming/overload mappings, ownership, async/cancellation, errors, events, threading, security, native prerequisites, and live-grid setup.
- Replace placeholder examples with tested snippets and link all programs.
- Generate completeness reports and fix broken links/warnings.
## Validation
- `cargo doc --workspace --no-deps` is warning-free.
- Every mapped public item has useful docs and a C# concept/source link where appropriate.
- All documentation snippets and quick-start workflows are tested.
## Prerequisite
All implementation and program milestones are complete with their fixed parity suites green.
## Project constraints
- The released implementation is entirely native Rust and must pass the explicit no-CLR/no-bridge artifact audit.
- Do not weaken API coverage or semantic parity to satisfy hardening, performance, or packaging goals.
- Preserve reproducible evidence, update release documentation, and keep all default/live destructive boundaries explicit.
hugo
added this to the 12 - Hardening and release milestone 2026-08-08 08:26:26 +00:00
Added the publishable Rust API and C# migration guide covering crate/features, naming and overloads, ownership/disposal, async cancellation, errors, events, threading, security, native prerequisites, OpenSim setup, and all native programs.
Extended deterministic shim generation so all 3,066 mapped public types include their mapping decision and pinned C# source, and all 30,789 mapped members include C# signature plus ownership, async, error, overload, and mapping-kind contracts.
Added deterministic documentation coverage/report evidence, local Markdown path and anchor validation, 15 public crate overviews, five compiled guide snippets, two runnable examples, and an ubuntu-latest Rust 1.97 documentation workflow with audited native prerequisites.
5/5 guide doctests and both examples compiled and ran successfully
83/83 documented program library/CLI tests passed with zero ignored/skipped cases; localhost Vivox/WebRTC services executed for real
documentation audit/report regeneration and 65 local link/anchor checks are reproducible
strict clippy is green for the audit, examples, and all changed public crates
scoped Rust 1.96 checks are green solely for the stated MSRV compatibility claim; implementation and CI use Rust 1.97
This issue did not require a live grid login. No .env credentials were loaded and no live OpenSim result is claimed or silently skipped; the guide documents direct GRID_LOGIN_URL OpenSim use and explicit live gates.
Implemented in commit 5eb3f01 and pushed to main.
- Added the publishable Rust API and C# migration guide covering crate/features, naming and overloads, ownership/disposal, async cancellation, errors, events, threading, security, native prerequisites, OpenSim setup, and all native programs.
- Extended deterministic shim generation so all 3,066 mapped public types include their mapping decision and pinned C# source, and all 30,789 mapped members include C# signature plus ownership, async, error, overload, and mapping-kind contracts.
- Added deterministic documentation coverage/report evidence, local Markdown path and anchor validation, 15 public crate overviews, five compiled guide snippets, two runnable examples, and an ubuntu-latest Rust 1.97 documentation workflow with audited native prerequisites.
- Updated release-facing README status.
Validation completed:
- RUSTDOCFLAGS="-D warnings" cargo doc --workspace --no-deps --locked -j 1
- 5/5 guide doctests and both examples compiled and ran successfully
- 83/83 documented program library/CLI tests passed with zero ignored/skipped cases; localhost Vivox/WebRTC services executed for real
- documentation audit/report regeneration and 65 local link/anchor checks are reproducible
- strict clippy is green for the audit, examples, and all changed public crates
- scoped Rust 1.96 checks are green solely for the stated MSRV compatibility claim; implementation and CI use Rust 1.97
This issue did not require a live grid login. No .env credentials were loaded and no live OpenSim result is claimed or silently skipped; the guide documents direct GRID_LOGIN_URL OpenSim use and explicit live gates.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Objective
Produce publishable documentation for every public crate/item and a practical C# to Rust migration guide.
Deliverables
Validation
cargo doc --workspace --no-depsis warning-free.Prerequisite
All implementation and program milestones are complete with their fixed parity suites green.
Project constraints
Implemented in commit
5eb3f01and pushed to main.Validation completed:
This issue did not require a live grid login. No .env credentials were loaded and no live OpenSim result is claimed or silently skipped; the guide documents direct GRID_LOGIN_URL OpenSim use and explicit live gates.