[drupal-docs] Admin help needs to be read by CivicSpace users

[Dan Robinson]

I looked through the text last night and I would like to extend a big 
hand to Kieran and all the folks who worked on this project - great 
work.  Having said that I would concur with Liza's observations.  
Basically my question is that if I wanted to contribute to editing and 
adding to this project where would I go to do that?  Also beyond that it 
seems that we need a way of creating our own versions of the 
documentation.  I don't believe that the entire community will be able 
to come to agreement on what audience the documentation should be 
targetted at - since the community and it's "customers" are so broad.  
So I would like to have a path carved out so that we can create multiple 
versions of the documentation and share that with those who are dealing 
with similar segments.  For example I really like the direction that 
Liza is headed in and it suites our purposes very well.

Regards,

Dan


> Kieran,
>
> How pressed for time are we? I'm trying to get my head above water 
> these days and just by eyeballing the manuals, I'd have to spend a lot 
> more time on them than what I have at the moment.
>
> For example, this is on the about page:
>
>> Drupal is software that allows an individual or a community of users 
>> to easily publish, manage and organize a great variety of content on 
>> a website.
>
>
> If it were up to me, the word CONTENT would not appear at all on this 
> page. OK, maybe once.
>
> Dynamic sites (that is, sites powered with CMS's or interactive net 
> media) are not about "CONTENT". They are about "presence", "persona". 
> Newspapers and magazines offer content. But everybody else who has a 
> dynamic site is doing it to not just establish their presence on the 
> web but to use the web to EXPAND, EXTEND AND AUGMENT who they are as 
> an organization or an individual THROUGH THE WEB.
>
> I really want to start working on creating a more powerful vision for 
> Drupal and CivicSpace that goes beyond the idea their CMS's. It makes 
> selling the idea of a dynamic site far more easier by taking away the 
> techno-speak and treating it as what it really is : an extension of 
> human activity.
>
> Best,
> liza sabater
> www.culturekitchen.com
>
>
>
> On May 27 2005, at 03:25, Kieran Lal wrote:
>
>> Howdy, 203 of you completed the documentation survey and told us that 
>> the number one thing you wanted was module documentation.
>>
>> The goal of this admin help documentation is:
>> 1) Provide documentation for modules.
>> 2) Improve the usability of the admin help.
>> 3) Improve the documentation teams ability to work with admin help by 
>> single sourcing it from the documentation handbook.
>>
>> Here is the documentation for the core 
>> modules:http://drupal.org/handbook/modules
>> Here is the documentation for the added modules: 
>> http://drupal.org/handbook/modules/contributions
>>
>> The handbook module pages start with executive summaries that are 
>> also admin help.  Pretty clever, don't you think.  The handbooks are 
>> currently under development, stay tuned for more improvements.  It 
>> would be greatly appreciated if knowledgeable CivicSpace users could 
>> read some of them and report back on where they are wrong.
>>
>> If you need a site to confirm this documentation, create an account 
>> on: http://demo.civicspacelabs.org/home and send me a link to your 
>> profile.  I'll make sure you get the access you need to confirm the 
>> documentation is accurate.
>>
>> Thanks for you help,
>> Kieran
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: 
>> civicspace-community-unsubscribe at civicspacelabs.org
>> For additional commands, e-mail: 
>> civicspace-community-help at civicspacelabs.org
>>
>>
> Liza Sabater
> Blog Publisher
> www.culturekitchen.com
>
> AIM - cultkitdiva
> SKYPE - lizasabater
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: 
> civicspace-community-unsubscribe at civicspacelabs.org
> For additional commands, e-mail: 
> civicspace-community-help at civicspacelabs.org
>
>