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