[wp-docs] Simple How To for Functions.php
justin at justin-ryan.com
Tue Nov 15 03:51:15 UTC 2011
> 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>
> <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
> 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!
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.
« JR »
justin at linuxjournal.com
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the wp-docs