Unclear vector/slice comparison in section 2.12 of docs

[maxbrunsfeld]

Thanks for creating such readable docs!

When vectors are introduced in section 2.12, an analogy is made involving slices:

Vectors are to slices what String is to &str.

But I don't think slices have been introduced yet; they're introduced later in that section:

A slice is a reference to (or "view" into) an array.

Maybe the first quote should compare vectors to arrays, rather than slices?

[steveklabnik]

You're welcome!

So, one thing is that we generally assume that these are read out of order. I'm working on a new TOC that should address larger issues, but this might be an inter-issue. I'm pretty sure we talked about slices in section 1, though, do you happen to know?

[maxbrunsfeld]

Yeah, I was reading the sections out of order myself; I'm talking about the ordering within this one section though. Vectors are introduced first, and explained via an analogy with slices. Then slices are introduced further down.

[steveklabnik]

yes, understood. I was just wondering if this is the first place we ever talk about slices, or if they were mentioned before?

That doesn't make this bug invalid, I'm just curious.

[maxbrunsfeld]

I don't think that they are. String slices are introduced in the previous section though.