name and chunks clarification

[arackaf]

1. Read and sign the CLA. This needs to be done only once. PRs that haven't signed it won't be accepted.

signed

2. Make sure your PR complies with the writer's guide.
3. Read through the PR diff carefully as sometimes this can reveal issues. The work will be reviewed, but this can save some effort.
4. Remove these instructions from your PR as they are for your eyes only.

[skipjack]

@arackaf thanks again for your contribution. As I was merging #1345 and #1370 I noticed there was a fair amount of overlap. I'm going to close as I think the changes here are covered by those two but feel free to update this branch and re-open if you think something is still missing.

Also, those comment blocks in that plugin are starting to get a bit long. Maybe we should leave examples for the bottom sections and possibly consider changing how that page is laid out at some point (i.e. moving some of the docs out of comments).

[arackaf]

No problem - I'm glad the docs are clarified, no matter the source.