r? @pcwalton

(rust_highfive has picked a reviewer for you, use r? to override)

Thanks for @jorisgio reminding me that the binding of let can happen later in control flow.
So it is one reason to remain the doc as-is.

But consider this:

fn main() {
    let (x, (y,));
    x = 10;
    y = true;
}

playpen
If you say this let is introducing variables, I don't want to believe that.

I still suggest there's no "variable definition" in Rust.

In my opinion, in let mut x = 4; x += 1;, x is a variable. As for the let x; it's just a split binding pattern.

The official term is 'variable bindings', though sometimes, people just say one or the other.

I do think this needs improvement and this is overall an improvement, just some nits :)

Thanks :)
r? @steveklabnik

@bors: r+ rollup

📌 Commit c9454b1 has been approved by steveklabnik