<div dir="ltr">@A I know this is an old story, organizing documentation, allow me to say that a summary table (like SiteMap)<div> would really be of help. My efforts to get as much deeply in the "Drupal.org Handbooks" structure did bring me</div>
<div> first to learn to understand "TERMS" (I'm no native English) and collect them in <a href="http://drupal.org/node/302232">Common expressions & acronyms used on D.O.</a> wich help me (and hopefully all) to find what I'm looking for.</div>
<div><br></div><div> It will take more time for me to build from that from me so called "Index-page" an orientation resource that</div><div> will bring me suddenly what I'm looking for. I understand that even myself tend to unconsciously have</div>
<div> preferences to some sections because it's the actual theme I'm working on, this is why an "Index-page" or Table</div><div> would satisfy neutrally all orientations and search preferences.</div><div>
<br></div><div><br></div><div><br></div><div><div class="gmail_quote">On Sun, Oct 12, 2008 at 6:07 PM, Ryan Cross <span dir="ltr"><<a href="mailto:drupal@ryancross.com">drupal@ryancross.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<div dir="ltr">The real problem is that you need to address the documentation on several different levels. <br><br>- Topical<br>- Type (learning style, audience, etc)<br>- Version (especially important as we continue to expand our maintenance of more versions) <br>
- (and potentially quality, completeness, etc)<br><br>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. <br>
<br>Throughout my experience with Drupal I have found need to locate documentation on all these levels. <br><div><div></div><div class="Wj3C7c"><br><br><br><div class="gmail_quote">On Mon, Oct 13, 2008 at 2:55 AM, Emma Jane Hogbin <span dir="ltr"><<a href="mailto:emmajane@xtrinsic.com" target="_blank">emmajane@xtrinsic.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="border-left:1px solid rgb(204, 204, 204);margin:0pt 0pt 0pt 0.8ex;padding-left:1ex"><div>Lee Hunter wrote:<br>
> "Theme Guide" works well as a heading because it's clear that I'm<br>
> going to find information about theming. On the other hand, "Howto",<br>
> "Tutorial", "FAQ", "Best Practices" etc are all poor headings because<br>
> they are so vague and meaningless that they can, and do, address any<br>
> topic under the sun including theming, installation, hosting,<br>
> development, using modules, etc.<br>
<br>
</div>I have to throw in my +1 here. I have a strong dislike for documentation<br>
that is sorted by "type" of documentation rather than "content" of<br>
documentation. Of course if there was a link at the bottom of the page<br>
that said, "see this as a ____ format ____" for different learning<br>
styles that would be super awesome.<br>
<br>
<br>
regards,<br>
emma<br>
<font color="#888888"><br>
--<br>
Emma Jane Hogbin, B.Sc.<br>
Founder, xtrinsic<br>
phone: (519) 371-2665<br>
web: <a href="http://www.xtrinsic.com" target="_blank">www.xtrinsic.com</a><br>
</font><div><div></div><div>--<br>
Pending work: <a href="http://drupal.org/project/issues/documentation/" target="_blank">http://drupal.org/project/issues/documentation/</a><br>
List archives: <a href="http://lists.drupal.org/pipermail/documentation/" target="_blank">http://lists.drupal.org/pipermail/documentation/</a><br>
</div></div></blockquote></div><br></div></div></div>
<br>--<br>
Pending work: <a href="http://drupal.org/project/issues/documentation/" target="_blank">http://drupal.org/project/issues/documentation/</a><br>
List archives: <a href="http://lists.drupal.org/pipermail/documentation/" target="_blank">http://lists.drupal.org/pipermail/documentation/</a><br></blockquote></div><br><br clear="all"><br>-- <br>Sincerely Best Regards<br>
<br>Wolf J. Zirbs<br>Drupal.org Site Maintainer<br>Blog <a href="http://wolf.zirbs.garschagen.at">http://wolf.zirbs.garschagen.at</a><br>
</div></div>