[wp-docs] New Wiki

[Alex]

I'm not an expert on this, but I think the general rule (grammar?) on  
numbers is that anything 10 or less is spelled out, and anything  
greater is numerical.
ie:

"Five Minute Installation"
"Ten Minute Template Customization Guide"
"11 Minute Plugin Tutorial"

I could be wrong on this. Not sure what reasoning is behind not have  
any numbers at all, but this is all I know and just commentary.

as an aside, 'Five Minute Installation' could be 'Five Step  
Installation' (re: Craig's IMO). Five steps might not be accurate, but  
suggestion anyways.

pseudo-reference:  
http://en.wikipedia.org/wiki/Wikipedia: 
Manual_of_Style_%28dates_and_numbers%29#Style_for_numbers.2C_weights.2C_ 
and_measures

-Alex


On Jul 30, 2004, at 1:59 PM, Craig Hartel wrote:

> Thanks, Matt, for setting up a great tool for us to use.
>
> Now, I beg of you all...PLEASE...
>
> Read the introduction to the wiki. Read the basic instructions. Please  
> think carefully about what you are writing and how you are setting it  
> up. Already I am concerned that we are going to have a mirror of the  
> old wiki which badly needed some organization.
>
> We need some top-level pages to organize the information. What follows  
> is a rough outline as an example.
>
> 	- Installing WordPress
> 		- Database creation
> 		- wp-config.php
> 		- Install procedure
>
> 	- The WordPress Folder
> 		- Basic description of the folders and contents
>
> 	- Customizing WordPress
> 		- Structural Changes - PHP files
> 		- Visual Changes - CSS files
> 		- Template Tags
>
> 	- Troubleshooting
> 		- Database connection errors
> 		- Login errors
>
> 	- External resources
> 		- PHP
> 		- CSS
> 		- Portal sites
>
> We need to AVOID using numbers in the page names, IMO. i.e. 5 Minute  
> Install. Also, I don't care for that title at all, because some people  
> might take twenty minutes, just because they wish to be careful and  
> thorough, and perhaps the title will add to their feeling of  
> noobishness.
>
> All docs should be considered DRAFT and should go through a basic  
> "edit" or review to ensure spelling and other issues are taken care  
> of.
>
> If we don't get a handle on structure and organization soon, then we  
> are going to create a big mess that will be no easier to follow than  
> the old wiki. I appreciate that everyone is doing the right thing and  
> is volunteering their time and talents to help this effort, but we  
> have to do it in an orderly fashion or our time will be wasted.
>
> Yes, the documentation is behind the development cycle, but in my  
> opinion, it cannot, and should not, attempt to keep pace with  
> development. It will be a very important source of information, and  
> can make or break peoples' opinions about WordPress.
>
> Let's not get drunk with enthusiasm over a new toy to play with. I  
> know that this note will sound like I'm crapping all over things, but  
> that's not my intention.
>
> I invite your comments and feedback.
> Craig.
>
> _______________________________________________
> docs mailing list
> docs at wordpress.org
> http://wordpress.org/mailman/listinfo/docs_wordpress.org