Documents invalid use of `attr` for attribute of `id`

There is an assertion that prevents the use of `attr` to define a
attributes named `id`, this adds API documentation of that fact
Merge pull request #1816 from danmcclain/attr-id-doc

Documents invalid use of `attr` for attribute of `id`