3 ms·

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 https://github.

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 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 https://news.ycombinator.com/item?id=12066259 . For example, https://doc.rust-lang.org/nomicon/send-and-sync.html 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-send-and-sync/ https://nyanpasu64.github.io/blog/an-unsafe-tour-of-rust-s-s...

j-pb 6y ago
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.
nyanpasu64 6y ago
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/8551afbb2ca6f5ea37fe58380318b209785e4e02#diff-6f230c255f5a182556cd4595703fe3a12acddd41103c6ec29ceec6930544fdc3 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#example 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 6y ago
  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 6y ago
Yeah, considering it's mythical status, I found the material rather thin and uninformative :/

j-pb 6y ago

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.

nyanpasu64 6y ago

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/8551afbb2ca6f5ea37fe58380318b209785e4e02#diff-6f230c255f5a182556cd4595703fe3a12acddd41103c6ec29ceec6930544fdc3 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#example 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 6y ago
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 6y ago

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