Skip to content

Make rustdoc hold most documentation#331

Merged
cgwalters merged 1 commit into
composefs:mainfrom
cgwalters:website
Jun 26, 2026
Merged

Make rustdoc hold most documentation#331
cgwalters merged 1 commit into
composefs:mainfrom
cgwalters:website

Conversation

@cgwalters

Copy link
Copy Markdown
Collaborator

I want composefs to have a website with useful docs. After some reflection, what I think is the least effort and most clear right now is just to move things into the Rust documentation.

So things like the repository format, splitstream definition now live there. The pattern is that we have #[cfg(doc)] mod foo; for things that only need to live in docs.

Add information about varlink there too.

Assisted-by: OpenCode (claude-opus-4-6)

@cgwalters cgwalters requested a review from giuseppe June 26, 2026 15:26
Comment thread crates/composefs/src/splitstream_format.rs
Comment thread crates/composefs-boot/src/design.rs Outdated
@cgwalters

Copy link
Copy Markdown
Collaborator Author

Ah, the random proptest run in this PR caught a bug, #332

I want composefs to have a website with useful docs. After some
reflection, what I think is the least effort and most clear right
now is just to move things into the Rust documentation.

So things like the repository format, splitstream definition now
live there. The pattern is that we have `#[cfg(doc)] mod foo;`
for things that only need to live in docs.

Add information about varlink there too.

Assisted-by: OpenCode (claude-opus-4-6)
Signed-off-by: Colin Walters <walters@verbum.org>

@giuseppe giuseppe left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

LGTM

@cgwalters cgwalters added this pull request to the merge queue Jun 26, 2026
@github-merge-queue github-merge-queue Bot removed this pull request from the merge queue due to failed status checks Jun 26, 2026
@cgwalters cgwalters added this pull request to the merge queue Jun 26, 2026
Merged via the queue into composefs:main with commit 81e47d2 Jun 26, 2026
18 checks 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.

2 participants