[documentation] Fwd: Documentation Team: 'Doc IRC meeting: Feb 19' at groups.drupal.org

[Emma Jane Hogbin]

Addison Berry wrote:
>> Mark Boulton gave us an editorial guide for the redesign that is  
>> just around the corner (like within a month or so). The editorial  
>> guide covers all of the text on D.o so we need to review it, discuss  
>> and decide the best course of action to implement it. You can read  
>> the guide here: http://infrastructure.drupal.org/drupal.org-style-guide/editorial.html 

I won't be able to make it to the meeting, but here are a few comments
from me:

Overall it looks excellent! i have a few points of disagreement which
I've noted below.

1. e-mail, not email
I disagree (there are a few e-word examples). I think common usage omits
the hyphen. Although our own e-Commerce module follows none of the right
rules. :)

2. With the use of the word "web" these three items seems inconsistent:
# website or site, not web-site or web site
# homepage, not home page
# web page

I personally use: Web (with a cap) plus whatever it is. For example: Web
site; Web page. It seems odd that "website" is one word but "web page"
is two.


3. Don't use double hyphens; use the HTML entity.
And then about ten paragraphs later they use a double dash instead of
the HTML entity. Realistically I think there are very few who will take
the time to memorize the entity (I know I wimp out and use the double dash).



regards,
emma

-- 
Emma Jane Hogbin
e. emma at hicktech.com - web. www.hicktech.com