[theme-reviewers] Theme review protocol for information about the requirements.

[Edward Caissie]

The Theme Unit Test data, aside from the obvious required content for review
purposes, should include on every post and page:

   - appropriate (codex) links
   - plain language explanations
   - sample (code) usage
   - any other relevant details specific to the test item

I see this as improving the test unit content as well as providing the
additional educational information new and old authors alike would find
useful.

Of course this may duplicate some information already in the codex, but it
will also be less clicks to find and therefore more likely to be read and
put to use.


Cais.

On Thu, Aug 26, 2010 at 1:22 AM, Philip M. Hofer (Frumph) <philip at frumph.net
> wrote:

>  One of the points that is so 'avidly' brought up is the knowledge of the
> where and why something is required and how to adjust their themes
> accordingly.   This documentation is readily available on the codex, if it
> is not it should be adjusted as so.   Regarding this as well I'm proposing
> that we 'link' to the appropriate documentation in the theme review; or
> create a separate codex page under the theme_review page that itemizes it
> with more information that the developer can look at.
>
> This will assist in 'levelling up' those developers with readily accessable
> information, as in example:
>
>
> => Floats not clearing at the end of posts and pages.
> http://codex.wordpress.org/Theme_Unit_Test#Clearing_Floats
>
> And in that portion give a more verbose explanation of common problems why
> its not clearing and an explanation of what to do to clear it.
>
> - Phil
>
> I believe since Otto is inclined to want this, maybe he should consider
> working on the documentation upgrade for this.  Although I believe it's the
> codex for the functions them self that should have this information inside
> of it, the other area's that are not covered should as well be addressed.
>
>
>
> _______________________________________________
> theme-reviewers mailing list
> theme-reviewers at lists.wordpress.org
> http://lists.wordpress.org/mailman/listinfo/theme-reviewers
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.wordpress.org/pipermail/theme-reviewers/attachments/20100826/a9dbddc7/attachment.htm>