The indentation section says:
Your indentation should always reflect logical structure.
I believe this statement makes assumptions, and would be best backed up with examples. I’d propose:
Your indentation should always reflect logical structure. As a rule of thumb, indent the line following an opening tag.
This code has no indentation:function do_stuff() {
if ( condition ) { ?>
<ul>
<li>something1</li>
<li>something2</li>
</ul>
<?php }
}
This code is inconsistently indented:
function do_stuff() {
if ( condition ) { ?>
<ul>
<li>something1</li>
<li>something2</li>
</ul>
<?php }
}
This code is correctly indented:
function do_stuff() {
if ( condition ) { ?>
<ul>
<li>something1</li>
<li>something2</li>
</ul>
<?php }
}
I agree about adding indentation examples to the coding standards. Of course if we use mixed PHP/HTML, we'll also have to decide one way or the other on same-line or new-line PHP tags as well :)