I've taken a stab at making use of the Plugin-standard readme for a Theme. See my example here: <<meta http-equiv="content-type" content="text/html; charset=utf-8"><a href="http://themes.trac.wordpress.org/ticket/1273">http://themes.trac.wordpress.org/ticket/1273</a>><div>
<br></div><div>Chip<br><br><div class="gmail_quote">On Sat, Sep 25, 2010 at 9:37 PM, Edward Caissie <span dir="ltr"><<a href="mailto:edward.caissie@gmail.com">edward.caissie@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
I think the file itself should be required ...<br><br>... as to formatting and other related criteria, I think using the Plugin repository version as a template would work well as a starting point.<br><br>If we can get some idea if this is possible, and a reasonable(?) time-line, we can start working on what could be expected to be included in the file, too.<br>
<br><br>Cais.<div><div></div><div class="h5"><br><br><div class="gmail_quote">On Sat, Sep 25, 2010 at 10:32 PM, Chip Bennett <span dir="ltr"><<a href="mailto:chip@chipbennett.net" target="_blank">chip@chipbennett.net</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0pt 0pt 0pt 0.8ex;border-left:1px solid rgb(204, 204, 204);padding-left:1ex">
That is exactly my reasoning for bringing it up.<div><br></div><div>Being able to have repository listing-page sections for FAQs, Use Instructions, etc. would be an incredible boon. And getting Theme developers in the habit of adding readme documentation similar to what Plugin developers provide can only help end-users.</div>
<div><br></div><div>Also, as the Review Team more and more require certain Theme customizations and intended uses (e.g. for "specialized-use" Themes) to be documented, having a standard readme format will help Theme developers comply with such requirements.</div>
<div><br></div><div><font color="#888888">Chip</font><div><div></div><div><br><br><div class="gmail_quote">On Sat, Sep 25, 2010 at 9:13 PM, Edward Caissie <span dir="ltr"><<a href="mailto:edward.caissie@gmail.com" target="_blank">edward.caissie@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0pt 0pt 0pt 0.8ex;border-left:1px solid rgb(204, 204, 204);padding-left:1ex">
+1 to this idea.<br><br>It would go a long way to adding, in some cases, much needed theme documentation.<br><br><br>Cais.<br><br><div class="gmail_quote"><div><div></div><div>On Sat, Sep 25, 2010 at 10:09 PM, Chip Bennett <span dir="ltr"><<a href="mailto:chip@chipbennett.net" target="_blank">chip@chipbennett.net</a>></span> wrote:<br>
</div></div><blockquote class="gmail_quote" style="margin:0pt 0pt 0pt 0.8ex;border-left:1px solid rgb(204, 204, 204);padding-left:1ex"><div><div></div><div>Mostly a question for Joseph and Otto:<div><br></div>
<div>What would it take to implement the ability for Themes to provide a Plugin-like Readme.txt (using the same markdown, and generating the same sections on the Theme's repository listing page)?</div>
<div><br></div><div>I know this suggestion has been kicking around for a LONG time... what can we do to make it happen?</div><div><br></div><font color="#888888"><div>Chip</div>
</font><br></div></div>_______________________________________________<br>
theme-reviewers mailing list<br>
<a href="mailto:theme-reviewers@lists.wordpress.org" target="_blank">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>
<br>_______________________________________________<br>
theme-reviewers mailing list<br>
<a href="mailto:theme-reviewers@lists.wordpress.org" target="_blank">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></div></div>
<br>_______________________________________________<br>
theme-reviewers mailing list<br>
<a href="mailto:theme-reviewers@lists.wordpress.org" target="_blank">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></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>