Inline documentation for can.inserted

Fixes #755
Updated can.attr docs

Updated with a few more changes, like a better introduction that
describes why the module exists, and what it enables for the end user.
Also fixing an example in the 2.1 docs. Related to #757
Merge branch 'can-inserted-docs' into docco
Merge branch 'attr-docs' into docco