[wp-docs] New Pages.

[Morgan Doocy]

Oh, and one more:

4. As with "How to" and instructions, titles of articles which simply 
describe something (as noted in #3) should never begin with "About," 
One notable exception to this rule is "About WordPress," which would be 
insufficiently descriptive without the "About."

Morgan

On Feb 21, 2005, at 12:53 PM, Morgan Doocy wrote:

> With regards to style guidelines for title names, I'll just reiterate 
> a couple of rules that I've mentioned before.
>
> 1. Titles should never begin with "How to," unless it is absolutely 
> necessary to do so.
> 2. Titles which give instructions on how to do something should use 
> verbs in the present participle (-ing) rather than present tense. For 
> example, "Installing WordPress" should be used rather than "Install 
> WordPress."
> 3. Titles which simply describe a subject ("Blog Design and Layout") 
> or object ("Administration Panels") should use only nouns. (Note that 
> "Design" and "Layout" can also be verbs, but in this example they are 
> used as nouns.)
>
> These rules are extremely standardized in the print world; any good 
> reference book will adhere to them.
>
> Morgan
>
> On Feb 20, 2005, at 11:53 PM, Carthik Sharma wrote:
>
>> I have a proposal regarding the creation of new pages:
>>
>> The Problem:
>> Too many new pages, with titles that are all over the place, and that
>> are not linked-to from other pages.
>>
>> Current Solution:
>> Create new pages as subpages of User: pages, and then move them in 
>> later.
>>
>> Proposal:
>> 1. Sysadmins and Bureaucrats should be able to move in pages as and
>> when they like, without having to check back and forth for speedier
>> development.
>> 2. We need to agree on some standards for page titles and stick to the
>> standards.
>>
>> Benefit: Speed up moving in of useful pages. Don't frustrate doc
>> writers (MDAWaffe comes to mind, among others :) )
>>
>> Suggested Standards for Sysops, bureaucrats creating new pages:
>> 1. Titles are in Title Case, so "Using the Link Manager" is used, not
>> "Using the link manager". (we need exactly one method, and this method
>> is already in vogue.)
>> 2. Titles are action or task oriented whenever possible.
>> 3. A new page should be relatively complete, containing useful
>> information that is immediately useful to the end user. No blank new
>> pages.
>> 4. A new page should always be linked-to from some other page(s). No
>> bastard pages.
>> 5. Titles shall not have leading or trailing spaces.
>> 7. In case of doubt regarding the suitability of a name, mail the
>> wp-docs list asking for suggestions. Suggestions should be received in
>> less than two days. Hold your peace after two days :)
>> 8. The page creator's title suggestion should be used as long as it is
>> sensible and does not violate any rules given here.
>> 9. Shorter titles are better.
>> 10. Avoid prepositions in Titles.
>>
>> Exception:
>> Sub-pages are created after discussion, always.
>>
>>
>> If you have an opinion regarding these practices, voice them now,
>> within 5 days. Improve the rules above. Decision making threads like
>> this one should have a resolution, summarized in a mail to the thread,
>> at the end of 5 days (which is yet another proposal), unless there is
>> some special circumstance, which neccessitates extended discussion.
>>
>> Carthik.
>>
>> -- 
>> When nothing is done, nothing is left undone -- 老子 Lǎozi
>>
>> University of Central Florida
>> Homepage: http://carthik.net
>> _______________________________________________
>> wp-docs mailing list
>> wp-docs at lists.automattic.com
>> http://lists.automattic.com/mailman/listinfo/wp-docs
>
> _______________________________________________
> wp-docs mailing list
> wp-docs at lists.automattic.com
> http://lists.automattic.com/mailman/listinfo/wp-docs