[wp-docs] : WordPress-Generated CSS Classes for Menus (Chip

[Tom Auger (personal)]

Hey Chip, in order to better understand your position, I think I'll need
some clarification on why you don't want some very small examples of the CSS
(you wouldn't need any HTML, since the markup is auto generated by the very
functions you're documenting). Obviously we do PHP examples all over the
place, why should it be different for CSS when it's apposite to the topic at
hand?

Just some anecdotal experience here: I have recently hired two new web
developers, rather fresh out of school, and to them it was quite a mystery
as to how to highlight selected menu items etc. Of the two, I think one
could have figured it out given a list of all the classes available, but the
other who was a more visual learner, really needed to be shown once how all
those classes could be leveraged.

Just in terms of making the documentation as complete as possible, and as
useful as possible to all viewers of various experience levels, I thought it
might be handy to just give a hint or two of how these classes might be
leveraged in a real-world scenario.

I do like Evan's suggestion of using examples from the official themes that
ship with WP. That seems right to me. I guess the only issue there is what
do we do when Twenty-Twelve ships (looking like 3.5 at the moment, so still
a few months off)?

Tom

------------------------------

Message: 2
Date: Wed, 18 Apr 2012 11:42:16 -0500
From: Chip Bennett <chip at chipbennett.net>
Subject: Re: [wp-docs] WordPress-Generated CSS Classes for Menus (Chip
	Bennett)
To: WordPress Documentation <wp-docs at lists.automattic.com>
Message-ID:
	<CAPdLKqcdgqax9-iejR3-hOaDL36Su4W6D9feoxfFeqKFrSmP=Q at mail.gmail.com>
Content-Type: text/plain; charset="iso-8859-1"

Tom,

I'm conflicted regarding adding basic CSS/HTML markup examples to the
Codex. Once one knows the classes that are applied to the HTML LI tags,
using those tags for CSS styling should be fairly trivial. Do we do this
elsewhere in the Codex?

If need be, we can add examples from Twenty Eleven's style.css...

Chip