spec: documentation of len() in string type unclear

[fabulousduck]

go/doc/go_spec.html

Line 833 in f58b02a

The length of a string <code>s</code> (its size in bytes) can be discovered using

The documentation on how specifically len() can be used to determine the size of a string type in bytes can be confusing as this would make you expect that len("go") would return 16 (like unsafe.Sizeof("go") would) but actually gives you 2

I would like to ask for a better phrasing of how to use len() on string type in the docs

[zigo101]

"go" has two bytes, so len("go") is 2. The docs is very clear on this. Why confused?

unsafe.Sizeof(anyStr) always returns 16, for every string value occupies 16 bytes in memroy on 64-bit arch.

[zigo101]

Ah, some misunderstanding here.
The doc is really not very clear here.
(the number of bytes stored in the string) would be better.

[gopherbot]

Change https://golang.org/cl/149077 mentions this issue: spec: be clearer about definition of string length