<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><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">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 class="Ih2E3d">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 class="Wj3C7c">--<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>