[drupal-docs] Doc forum, "best practices", etc.

[Ron Mahon]

Anisa
I think you right. It is lingo and not descriptive. "Best practices for
setting up menus" would fix it. 

However from a newbie point of view maybe what we need is an over view. I
leaning back to the future with a pictorial presentation, something left
over from structured programming days.

Can anyone tell me what program is used to make the sample screen shots in
the themes.

Ron

InterNet Marketing Resource Center
A Free Super Mart of Articles, Demos, Tutorials everything you need to
Succeed on the net.
www.inmrc.com 


-----Original Message-----
From: Anisa [mailto:mystavash at animecards.org] 
Sent: Sunday, April 10, 2005 3:15 AM
To: drupal-docs at drupal.org
Subject: Re: [drupal-docs] Doc forum, "best practices", etc.

I don't get a sense of the content from the title 'best practices'.  It
appears to be lingo.  :)

Why is it a best practices thingy?  Just skimming, it seems to be more about
the various Drupal bits.

Anisa.

Boris Mann wrote:

>I want to direct everyone's attention to the Documentation forum -- 
>http://drupal.org/forum/33. This is our on-Drupal.org spot for 
>discussing things.
>
>Carlo (a new member on this list and to Drupal -- welcome and thank
>you!) wrote a post (http://drupal.org/node/20173) asking about process 
>for having book pages approved. This is, of course, the difficulty in 
>not having notification of new book pages/pages in the queue.
>
>Also, while Carlo's has done a good write up, the tone and material is 
>not (IMHO) correct for documentation -- it's more of a "best practices" 
>document as we have been doing on our support site. For those that 
>don't have permission to view the node on Drupal.org, I've pasted the 
>content into the dev wiki here:
>http://dev.bryght.com/t/wiki/DrupalGeneralConcepts
>
>What do people think about "best practices" style articles? I think 
>this is very good information to have, especially when you could have 
>multiple "best practices" written for different situations or 
>viewpoints, but that it shouldn't be part of the main tree of 
>documentation. For Carlo's article, I would say that the audience would 
>be Site Admins, and the topic would be Site Setup and/or General 
>Concepts. We can quickly see some category terms emerging here.
>
>Anyway, just wanted to throw that out there and make sure people know 
>I'm still thinking about all this.
>
>--
>Boris Mann
>http://www.bryght.com
>  
>