<div dir="ltr">I think it isn't standard because there is no established consensus or convention for its usage. I think there is no such consensus or convention because there are too many valid ways to accomplish the same thing, and too many opinions regarding the appropriateness of this particular method.<div>
<br></div><div>For example, I make extensive use of inline PHPdocs in Oenology:</div><div><a href="https://github.com/chipbennett/oenology/blob/master/index.php">https://github.com/chipbennett/oenology/blob/master/index.php</a><br>
</div><div><br></div><div style>I don't think that additional HTML comments would add anything beneficial to the extant inline documentation.</div><div style><br></div><div style>That said, one thing that *is* helpful - though it can also be done with PHP rather than HTML comments - is indication of the CSS ID of closing containers (such as <div id="content">), since the opening and closing container tags are often found in different template-part files.</div>
</div><div class="gmail_extra"><br><br><div class="gmail_quote">On Sat, Feb 2, 2013 at 9:12 AM, Aaron Nimocks <span dir="ltr"><<a href="mailto:aaron_nimocks@yahoo.com" target="_blank">aaron_nimocks@yahoo.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div style="font-size:12pt;font-family:tahoma,new york,times,serif"><div>I haven't gave this complete thought yet but I would assume this has been brought up before so just wanted to know if it has or why we don't do this.</div>
<div><br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif">From a support or even end user perspective I would absolutely love if each template file was required to have a comment for when it started and ended. This way just viewing the source you can instantly tell which file it is in. I really don't think it would require too much effort for theme submitters but I think it would make a great deal of difference for supporting these themes as well as allowing end users to have a method of finding which page to edit.</div>
<div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif"><br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif">
Using something standard like</div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif"><br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif">
<!-- TEMPLATE FILE footer.php Start --></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif"><!-- TEMPLATE FILE footer.php End --></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif">
<br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif">or for hooks</div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif">
<br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif"><!-- TEMPLATE HOOK wp_footer Start --></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif">
<!-- TEMPLATE HOOK wp_footer End --></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif"><br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif">
I just went through real quick and adding some on <a href="http://www.wpbum.com/how-to-get-jobs-on-odesk.html" target="_blank">http://www.wpbum.com/how-to-get-jobs-on-odesk.html</a> for just page template and only took a few minutes. But by viewing the source code it makes it really easy to see where all the code is being generated from and where to go to edit.<br>
</div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif"><br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif">
Why isn't something like this a standard?</div><span class="HOEnZb"><font color="#888888"><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif"><br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:tahoma,new york,times,serif">
Aaron<br></div></font></span></div></div><br>_______________________________________________<br>
theme-reviewers mailing list<br>
<a href="mailto:theme-reviewers@lists.wordpress.org">theme-reviewers@lists.wordpress.org</a><br>
<a href="http://lists.wordpress.org/mailman/listinfo/theme-reviewers" target="_blank">http://lists.wordpress.org/mailman/listinfo/theme-reviewers</a><br>
<br></blockquote></div><br></div>