Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve documentation #384

Merged
merged 2 commits into from
Jan 28, 2025
Merged

Improve documentation #384

merged 2 commits into from
Jan 28, 2025

Conversation

glyn
Copy link
Contributor

@glyn glyn commented Jan 28, 2025

  • Improve README and share with rustdocs
  • Improve docs of one-shot servers
  • Tidy up lib.rs
  • Fix doc warning in router.rs

Delete documentation link from README as it doesn't look good in the docs. The documentation link (https://docs.rs/ipc-channel) should be moved to About->Website on the repository page at github.com.

* Improve README and share with rustdocs
* Improve docs of one-shot servers
* Tidy up lib.rs
* Fix doc warning in router.rs

Delete documentation link from README as it
doesn't look good in the docs. The documentation
link (https://docs.rs/ipc-channel) should be moved
to About->Website on the repository page at
github.com.
@glyn
Copy link
Contributor Author

glyn commented Jan 28, 2025

Looks like one of the benches hit a flake and needs re-running (I don't think I can do that). I haven't changed any code.

README.md Outdated

## Semantic differences from Rust channels

* Rust channels are MPSC (multi-producer, single-consumer) whereas ipc-channels are SPSC (single-producer, single-consumer).
Copy link
Member

Choose a reason for hiding this comment

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

This isn't true—you can clone IPC senders and the receiver will receive from all of them.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Oops. I was confusing this with the single-connect behaviour of one-shot servers.

@glyn glyn requested a review from jdm January 28, 2025 19:22
@jdm jdm added this pull request to the merge queue Jan 28, 2025
Merged via the queue into servo:main with commit f2729e1 Jan 28, 2025
16 checks passed
@glyn
Copy link
Contributor Author

glyn commented Jan 28, 2025

@jdm Thanks for merging. How do you feel about setting the documentation link (https://docs.rs/ipc-channel) as About->Website on the repository page on github.com?

@glyn glyn deleted the improve-docs branch January 28, 2025 19:51
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