Misc docs suggestions

It's the wording, which might imply that the semantics are dependent on the naming scheme if you read the paragraph on its own without context.