<div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">Message: 6<br>
Date: Fri, 11 Nov 2011 10:03:32 -0800<br>
From: Lorelle on WordPress <<a href="mailto:lorelleonwordpress@gmail.com">lorelleonwordpress@gmail.com</a>><br>
Subject: Re: [wp-docs] Simple How To for Functions.php<br>
To: WordPress Documentation <<a href="mailto:wp-docs@lists.automattic.com">wp-docs@lists.automattic.com</a>><br>
Message-ID:<br>
<CAN2v4ZQQu6QGnOCD-arJyPjSfXefXKW+v=<a href="mailto:jJjaSCExWH8V0zeA@mail.gmail.com">jJjaSCExWH8V0zeA@mail.gmail.com</a>><br>
Content-Type: text/plain; charset="iso-8859-1"<br>
<br>
The article is great, and wonderfully helpful! Just what we needed.<br>
<br>
just a couple notes that I thought I sent a while ago, but it appears not<br>
to have made it through to the docs mailing list. Consider these a reminder<br>
for everyone.<br>
<br>
1. WordPress has a capital P in the middle not lowercase.<br>
<br>
2. Plugin is Plugin not plugin or plug-in.<br>
<br>
3. Watch consistency. In the first lists you describe the Plugins directory<br>
as a directory and the Themes directory as a subdirectory. That implies<br>
they are two different things, which can add to confusion. Little things<br>
like this can throw someone off. Just be careful.<br>
<br>
4. Avoid one word links. For example in a sentence with "Use WordPress<br>
Hooks..." Hooks was in a link and WordPress Hooks should have been the<br>
link. We do this for accessibility as well as clarity. Tiny words are<br>
harder to click, and in this case, WordPress Hooks is a search term (unless<br>
they are looking for Captain. :D ). The sentence continues with single word<br>
links to actions and filters, which I've pretty much left because I can't<br>
seem to edit it without changing the context or being redundant, so this is<br>
always a challenge. Be judicial and try to keep them to a minimum of two<br>
words.<br>
<br>
I've fixed these and tightened it up a little for passive voice but the<br>
core is excellent! These are just reminder nitpicks. This is fabulous.<br>
Thank you so much!<br>
<br>
Lorelle<br><br></blockquote><div><br></div><div><font face="verdana, sans-serif">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.</font></div>
<div><span style="white-space: pre-wrap; "><font face="verdana, sans-serif"><br class="Apple-interchange-newline">Yours,</font></span></div><font face="verdana, sans-serif"><span style="white-space: pre-wrap; ">« JR »</span><br>
</font><div><font face="verdana, sans-serif"><font face="arial"><br></font></font></div><div><span style="font-family: verdana, sans-serif; "><div style="border-top-width: 2px; border-top-style: solid; border-top-color: rgb(136, 136, 136); border-bottom-width: 2px; border-bottom-style: solid; border-bottom-color: rgb(136, 136, 136); padding-top: 0px; padding-right: 15px; padding-bottom: 0px; padding-left: 15px; width: 425px; font-size: 14px; ">
<div style="float: left; "><p><strong><font color="#666666">Justin Ryan</font></strong><font color="#666666"><br>Writer/Editor<br>Office: 713.581.4335<br></font><a href="http://www.justin-ryan.com/" target="_blank" style="text-decoration: none !important; "><font color="#666666">www.justin-ryan.com</font></a></p>
</div><div style="float: left; margin-left: 40px; "><p><strong><font color="#666666">Linux Journal</font></strong><font color="#666666"><br>Contributing Editor<br></font><a href="mailto:justin@linuxjournal.com" target="_blank" style="text-decoration: none !important; "><font color="#666666">justin@linuxjournal.com</font></a><font color="#666666"><br>
</font><a href="http://www.linuxjournal.com/" target="_blank" style="text-decoration: none !important; "><font color="#666666">www.linuxjournal.com</font></a></p></div><br style="clear: both; "></div></span></div><div> </div>
</div>