Комментарий может появиться только до или после открывающего тега (независимо от того, является ли это пустой тег).
Комментарий может не появляются в start-tag из XML-элемента:
[40] STag ::= '<' Name (S Attribute)* S? '>'
Nor может комментарий появится внутри закрывающего тега:
[44] EmptyElemTag ::= '<' Name (S Attribute)* S? '/>'
В общем, в разделе 2.5 Comments:
[Определение: Комментарии могут появляться в любом месте документа вне другой markup; кроме того, они могут появляться в документе декларации типа в местах, разрешенных грамматикой. ...]
Вот один из способов документирования элемента атрибутов:
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:id="@+id/textView_ben"
android:layout_centerHorizontal="true"/>
<!--
android:id="@+id/textView_ben"
addresses defect #123
android:layout_centerHorizontal="true"
blah blah blah -->
В качестве альтернативы, такой комментарий может появиться перед тем по тегу; он просто не может появиться в пределах тег.
См. Http://stackoverflow.com/questions/26461869/how-to-comment-attributes-inside-xml-tag – DAB