Improve AA doc

Update examples.
Add 2 headings.
Remove remaining uses of hash_t.
Improve wording in 'Construction or Assignment on Setting AA Entries'
section.
Merge pull request #686 from ntrel/aa-doc-fixes

Improve AA doc