[documentation] Moving directory

Wolf Zirbs wolf.zirbs at gmail.com
Sun Oct 12 16:24:10 UTC 2008


@A I know this is an old story, organizing documentation, allow me to say
that a summary table (like SiteMap)   would really be of help. My efforts to
get as much deeply in the "Drupal.org Handbooks" structure did bring me
   first to learn to understand "TERMS" (I'm no native English) and collect
them in Common expressions & acronyms used on
D.O.<http://drupal.org/node/302232>  wich
help me (and hopefully all) to find what I'm looking for.

   It will take more time for me to build from that from me so called
"Index-page" an orientation resource that
   will bring me suddenly what I'm looking for. I understand that even
myself tend to unconsciously have
  preferences to some sections because it's the actual theme I'm working on,
this is why an "Index-page" or Table
  would satisfy neutrally all orientations and search preferences.



On Sun, Oct 12, 2008 at 6:07 PM, Ryan Cross <drupal at ryancross.com> wrote:

> The real problem is that you need to address the documentation on several
> different levels.
>
> - Topical
> - Type (learning style, audience, etc)
> - Version (especially important as we continue to expand our maintenance of
> more versions)
> - (and potentially quality, completeness, etc)
>
> Plus, not everyone goes to the documentation for a specific question /
> reference which requires good random/non-sequential access. Other people
> also want to be able to read documentation in a logical sequential order.
>
> Throughout my experience with Drupal I have found need to locate
> documentation on all these levels.
>
>
>
> On Mon, Oct 13, 2008 at 2:55 AM, Emma Jane Hogbin <emmajane at xtrinsic.com>wrote:
>
>> Lee Hunter wrote:
>> > "Theme Guide" works well as a heading because it's clear that I'm
>> > going to find information about theming. On the other hand, "Howto",
>> > "Tutorial", "FAQ", "Best Practices" etc are all poor headings because
>> > they are so vague and meaningless that they can, and do, address any
>> > topic under the sun including theming, installation, hosting,
>> > development, using modules, etc.
>>
>> I have to throw in my +1 here. I have a strong dislike for documentation
>> that is sorted by "type" of documentation rather than "content" of
>> documentation. Of course if there was a link at the bottom of the page
>> that said, "see this as a ____ format ____" for different learning
>> styles that would be super awesome.
>>
>>
>> regards,
>> emma
>>
>> --
>> Emma Jane Hogbin, B.Sc.
>> Founder, xtrinsic
>> phone: (519) 371-2665
>> web: www.xtrinsic.com
>> --
>> Pending work: http://drupal.org/project/issues/documentation/
>> List archives: http://lists.drupal.org/pipermail/documentation/
>>
>
>
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
>



-- 
Sincerely Best Regards

Wolf J. Zirbs
Drupal.org Site Maintainer
Blog http://wolf.zirbs.garschagen.at
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.drupal.org/pipermail/documentation/attachments/20081012/c02c714c/attachment.htm 


More information about the documentation mailing list