I'm looking for the most terse way to document sections of my page, e.g. div sections.
Anything wrong with using the title
attribute, e.g.
<div title="Payment Area" class="form">
...
</div>
?
P.S. In case relevant, I'm using the IntelliJ IDE, but new to its various capabilities, e.g. automatic formatting control and other ways to be able to easily understand sections of my pages.
I would probably use id
s, that way you can also use them as hooks for your CSS and JavaScript.
Otherwise, Gabe's Answer makes a good case for data
attributes. John Resig explains why they are good here: http://ejohn.org/blog/html-5-data-attributes/