<div dir="ltr">@A I know this is an old story,&nbsp;organizing&nbsp;documentation, allow me to say that a summary table (like SiteMap)<div>&nbsp;&nbsp; would really be of help. My efforts to get as much deeply in the &quot;Drupal.org Handbooks&quot; structure did bring me</div>
<div>&nbsp;&nbsp; first to learn to&nbsp;understand&nbsp;&quot;TERMS&quot; (I&#39;m no native English) and collect them in&nbsp;<a href="http://drupal.org/node/302232">Common expressions &amp; acronyms used on D.O.</a>&nbsp;&nbsp;wich help me (and hopefully all) to find what I&#39;m looking for.</div>
<div><br></div><div>&nbsp;&nbsp; It will take more time for me to build from that from me so called &quot;Index-page&quot; an orientation resource that</div><div>&nbsp;&nbsp; will bring me suddenly what I&#39;m looking for. I&nbsp;understand&nbsp;that even myself tend to&nbsp;unconsciously&nbsp;have</div>
<div>&nbsp;&nbsp;preferences&nbsp;to some sections because it&#39;s the actual theme I&#39;m working on, this is why an &quot;Index-page&quot; or Table</div><div>&nbsp;&nbsp;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">&lt;<a href="mailto:drupal@ryancross.com">drupal@ryancross.com</a>&gt;</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)&nbsp; <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">&lt;<a href="mailto:emmajane@xtrinsic.com" target="_blank">emmajane@xtrinsic.com</a>&gt;</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>
&gt; &quot;Theme Guide&quot; works well as a heading because it&#39;s clear that I&#39;m<br>
&gt; going to find information about theming. On the other hand, &quot;Howto&quot;,<br>
&gt; &quot;Tutorial&quot;, &quot;FAQ&quot;, &quot;Best Practices&quot; etc are all poor headings because<br>
&gt; they are so vague and meaningless that they can, and do, address any<br>
&gt; topic under the sun including theming, installation, hosting,<br>
&gt; 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 &quot;type&quot; of documentation rather than &quot;content&quot; of<br>
documentation. Of course if there was a link at the bottom of the page<br>
that said, &quot;see this as a ____ format ____&quot; 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>