[wp-docs] Simple How To for Functions.php

[Justin Ryan]

>
> Message: 6
> Date: Fri, 11 Nov 2011 10:03:32 -0800
> From: Lorelle on WordPress <lorelleonwordpress at gmail.com>
> Subject: Re: [wp-docs] Simple How To for Functions.php
> To: WordPress Documentation <wp-docs at lists.automattic.com>
> Message-ID:
>        <CAN2v4ZQQu6QGnOCD-arJyPjSfXefXKW+v=jJjaSCExWH8V0zeA at mail.gmail.com
> >
> Content-Type: text/plain; charset="iso-8859-1"
>
> The article is great, and wonderfully helpful! Just what we needed.
>
> just a couple notes that I thought I sent a while ago, but it appears not
> to have made it through to the docs mailing list. Consider these a reminder
> for everyone.
>
> 1. WordPress has a capital P in the middle not lowercase.
>
> 2. Plugin is Plugin not plugin or plug-in.
>
> 3. Watch consistency. In the first lists you describe the Plugins directory
> as a directory and the Themes directory as a subdirectory. That implies
> they are two different things, which can add to confusion. Little things
> like this can throw someone off. Just be careful.
>
> 4. Avoid one word links. For example in a sentence with "Use WordPress
> Hooks..." Hooks was in a link and WordPress Hooks should have been the
> link. We do this for accessibility as well as clarity. Tiny words are
> harder to click, and in this case, WordPress Hooks is a search term (unless
> they are looking for Captain. :D ). The sentence continues with single word
> links to actions and filters, which I've pretty much left because I can't
> seem to edit it without changing the context or being redundant, so this is
> always a challenge. Be judicial and try to keep them to a minimum of two
> words.
>
> I've fixed these and tightened it up a little for passive voice but the
> core is excellent! These are just reminder nitpicks. This is fabulous.
> Thank you so much!
>
> Lorelle
>
>
I understand why the P in WordPress is always capitalised, but what's the
reason for capping the P in Plugin? Surely 'plugin' is a genericised term.

Yours,
« JR »

*Justin Ryan*
Writer/Editor
Office: 713.581.4335
www.justin-ryan.com

*Linux Journal*
Contributing Editor
justin at linuxjournal.com
www.linuxjournal.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.automattic.com/pipermail/wp-docs/attachments/20111115/fa9e908c/attachment.htm>