Update documentation on attributes for error recovery and reporting.

In particular, explain the purpose of each attribute first with knock-on changes of that. Also fold extended pin bullet into the pin bullet.
Merge pull request #43 from pjonsson/update-updated-attribute-documentation

Update documentation on attributes for error recovery and reporting.