On: The Rustonomicon

[nyanpasu64]

Sadly, IIRC the Nomicon hasn't seen a new release in a while (meaning there's unpublished Github commits at https://github.com/rust-lang/nomicon ), and there are some TODOs scattered throughout the document. It has been incomplete since 2016, as mentioned at https://news.ycombinator.com/item?id=12066259 .

For example, https://doc.rust-lang.org/nomicon/send-and-sync.html says:

> TODO: better explain what can or can't be Send or Sync. Sufficient to appeal only to data races?

Coincidentally I happen to have just written about this topic a few months ago: https://nyanpasu64.github.io/blog/an-unsafe-tour-of-rust-s-s...

[nyanpasu64 → nyanpasu64]

Update: Turns out the Send/Sync article did receive an update giving more information/guidance... on GitHub... and not on the actual published website. https://github.com/rust-lang/nomicon/commit/8551afbb2ca6f5ea...

Update 2: The changes to the GitHub repository are only being reflected in the nightly Nomicon, not the main webpage. Link to update: https://doc.rust-lang.org/nightly/nomicon/send-and-sync.html...

Update 3: Perhaps they are being reflected in the main webpage, but with a delay (possibly once per language release?)

[iudqnolq → nyanpasu64]

I wrote that with a lot of help from the excellent maintainers. They were very welcoming of a PR that needed a lot of work.

If you're interested in this sort of thing John Gjenset's YouTube channel is also a great resource.

[j-pb → nyanpasu64]

Yeah I found reading it a bit underwhelming considering it's mythical status. There isn't that much material and interesting things like Arc aren't covered.

[j-pb → nyanpasu64]

Yeah, considering it's mythical status, I found the material rather thin and uninformative :/