> > Message: 6 > Date: Fri, 11 Nov 2011 10:03:32 -0800 > From: Lorelle on WordPress <[email protected]> > Subject: Re: [wp-docs] Simple How To for Functions.php > To: WordPress Documentation <[email protected]> > Message-ID: > <CAN2v4ZQQu6QGnOCD-arJyPjSfXefXKW+v=jjjascexwh8v0...@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 [email protected] www.linuxjournal.com
_______________________________________________ wp-docs mailing list [email protected] http://lists.automattic.com/mailman/listinfo/wp-docs
