Message to theme developers

Do yourself and your users a favour and comment your code and your CSS.

I have looked at many themes (because I am currently preping my own stuff for release now that 1.5 is final) and I am suprised at the lack of any commenting or even hints what certain lines of code do or don’t.

Since so many people love to play with YOUR themes, why not give them a chance to explore your work and adopt it more easily to their liking?

Is this something like that too complicated?


<!-- headline of your post -->
<div class="category"><?php the_category(", ") ?>:</div>
<div class="title" id="post-<?php the_ID(); ?>">
<a href="<?php the_permalink() ?>" rel="bookmark"
title="Permanent Link to <?php the_title(); ?>">
<?php the_title(); ?></a>
</div>
<!-- end headline of your post -->


Especially with ‘long running’ styles and boxes it helps to tell people where one DIV starts and where it ends. I have seen themes with extremly nested DIV or four ‘ending’ DIVs which made it hard to understand what was going on …

Why not simply write something like this?

</div>
<!-- end section post -->

</div>
<!-- end section content -->


Also the CSS are often hardly structured of spread the style definitions over serveral entries. The new default style has several entries for the simple h2 tag:


h1, h2, h3 {
font-family: "Trebuchet MS", "Lucida Grande", Verdana, Arial, Sans-Serif;
font-weight: bold;
}

h2 {
font-size: 1.6em;
}

h2, h2 a, h2 a:visited, h3, h3 a, h3 a:visited {
color: #333;
}

a, h2 a:hover, h3 a:hover {
color: #06c;
text-decoration: none;
}

h2 {
margin: 30px 0 0;
}


I can perfectly see and understand the designers idea behind HIS way of organising the CSS – it is nevertheless confusing for mere mortals. And mere mortals will try to adopt your work … and pester you with support requests if they run into problems …

??