[drupal-docs] Round 4 of documentation sprint Admin help: merging into the handbook

puregin puregin at puregin.org
Tue May 24 20:35:51 UTC 2005


On 24 May 2005, at 12:17 PM, Charlie Lowe wrote:

> So to reiterate, yes, these are interesting ideas. And two people
> can/should form a documentation team to restructure this section of the
> book. But at the moment, Kieran needs feedback based upon his goals.
> Let's stay focused on the smaller picture now and save the bigger
> picture for when we have at least two volunteers ready to move forward
> with the larger project.
>

I agree that the larger picture of reorganizing the Administrator's 
guide
needs some deliberation, perhaps managed by a team.

I wasn't attempting to propose a final structure - just provide some
context for the argument that the new admin help pages should go into 
their
own new section(s).

     Djun

>
>
> puregin wrote:
>>      I'm a little concerned about making the Administrator's guide 
>> even
>> more confusing than it currently is.
>>
>>      I'm thinking of the new admin help as being similar in spirit
>> to Unix 'man pages', and I'm imagining collecting them all
>> into something which would essentially be an appendix -
>> used for reference.
>>

>>
>>       I'd like to see the Admin help become an appendix also.
>> Existing Admin help documentation could be put into a
>> 'Versions prior to 4.6' section of this appendix.
>>
>>       I propose an organization something like this:
>>
>>     Administrator's guide
>>       1. Introduction
>>       2. Installation
>>       3. Configuration
>>       4. Day-to-day administration
>>            ...
>>            Backups (was 8.)
>>            ...
>>       5. Cookbook
>>            ...
>>            Best practices (was 9.)
>>            ...
>>     A1. Drupal modules quick-help
>>            Core
>>            Contrib
>>            Versions prior to 4.6
>>     A2. Upgrading from previous versions (was 6.)
>>     A3. Migrating from other weblog software (was 7.)
>>     A4. Troubleshooting FAQ (was 10.)
>>
>
-




More information about the drupal-docs mailing list