Rephrase some of the documentation on attributes for error recovery and reporting.

This change is based on my understanding of what was said in #40. Changes are:

1. Moved the purpose of pin/name to the beginning of the first sentence in each bullet.
1. Moved the word "attribute" from all of the bullets into the section title.
1. Explicitly spelled out what pin expects as parameter.