[wp-docs] Adding Administration Menus

Michael D.Adams mikea at turbonet.com
Wed Mar 9 08:58:24 GMT 2005

On Mar 8, 2005, at 9:52 PM, Carthik Sharma wrote:

> Usually, the good thing about standards is that there are so many to
> choose from - but not in our case. So what do you say to we develop a
> standard vocabulary to refer to various elements in the WordPress UI,
> and nail them down in the Glossary, or in the codex_guidelines and
> stick to it, from now on?
Is something like 
http://codex.wordpress.org/User:MDAWaffe/WordPress_Terminology useful?

> Michael, I wrote up 90% of the doc required for 1.2's UI, till the
> complexity and the inanity got me. Repeating obvious things, and
> things that are already in text on the UI helps no one, so the
> challenge would be to answer the "why"s and "why not"s, rather than
> just the "what"s of various things - if you are creating UI based
> documentation. That is one reason I haven't really spent time reading
> the pages you wrote up, cause they can suck up a whole lot of time,
> and still be of little use to people - no one will want to know what
> some button is, a few will want to know why it is there, or why it's
> required, and not something else. A lot of people arrive at the Codex
> with a specific "how to" in mind. We should suck them in, and give
> them more info than what they came looking for - and hence, task-based
> docs that reference the UI docs will be cool to have.
Perhaps the problem (if there is one), then, is best solved with better 
innate documentation in WordPress itself.  Title attributes that 
specify what something is when hovered over?  A 'Help' Admin Panel?

> Point of this mail - decide nomenclature for different elements before
> proceeding, to preserve order.
> As for your page's name, I am glad to see the newly created page!
> Carthik
> On Tue, 08 Mar 2005 18:25:05 -0700, Craig Hartel 
> <craig at nuclearmoose.com> wrote:
>> I like panels over pages.
>> Craig.

More information about the wp-docs mailing list