Rust closure documentation is badly written for the advanced programmer.

No, I am not going to submit a PR. The underlying system is byzantine and I don't understand it, because the docs aren't sophisticated enough to describe the totality of behavior, instead retreating to examples of simple behavior.


I will also put this out there.

The bulk of good documentation should be for the advanced & experienced user. Simple & beginner documentation should be aimed at ramping the beginner to an advanced user.

In other words, the book "The Rust Programming Language" is inadequate for those with decent amounts of expertise. It's insufficient, not simply by lack of information, but by pedagogical design. There is no scaffolding to the total concept system of Rust.

Sign in to participate in the conversation
Seattle Social

An instance for people who live in or around Seattle. Also for people who don't live in or around Seattle, but want to talk about Seattle-related things. Almost all applications are accepted. We aim to review all applications within a few hours of submission, but give us 24 hours before getting in touch other ways.