It's the old problem of why many programs are insufficiently commented. There is never time to take a deep breath and go back and write cogent comments. It seems to be happening in Drupal too despite links like below (But thanks for the good intentions and motivational jibes). The good docs I find are most of the time outdated. Understandable given the pace of change here. <div>
<br><br><div class="gmail_quote">On Mon, Aug 8, 2011 at 3:54 AM, Stephen Karsch <span dir="ltr"><<a href="mailto:steve@stevekarsch.com">steve@stevekarsch.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
Exactly! Please see:<br>
<br>
<a href="http://www.lullabot.com/articles/drupal-best-practice-document-your-way-understanding" target="_blank">http://www.lullabot.com/articles/drupal-best-practice-document-your-way-understanding</a><br>
<br>
If you're having a particular problem with Drupal, chances are there are 100s of people having that same problem.<br>
<div><div></div><div class="h5"><br>
On Aug 8, 2011, at 6:32 AM, Gregg Marshall wrote:<br>
<br>
> Tony<br>
><br>
> While you are gaining the experience is the best time to at least be making notes on what you are learning. Once you have mastered something and try to go back to write it up, it is far too easy to think “oh everyone knows that” when in fact you didn’t while you were learning and the next person who you are leaving a breadcrumb trail for might not either.<br>
><br>
> Gregg<br>
><br>
> From: <a href="mailto:support-bounces@drupal.org">support-bounces@drupal.org</a> [mailto:<a href="mailto:support-bounces@drupal.org">support-bounces@drupal.org</a>] On Behalf Of tony maciejowski<br>
> Sent: Sunday, August 07, 2011 8:11 PM<br>
> To: <a href="mailto:support@drupal.org">support@drupal.org</a>; Ms. Nancy Wichmann<br>
> Subject: Re: [support] Portfolio page suggestions in Drupal 7<br>
><br>
> Good point Nancy. One of these days i will put down my experience in words. But that assumes that I have the experience, which I don't, yet. I seem to be getting there. Slowly.<br>
><br>
><br>
> On Sun, Aug 7, 2011 at 5:03 PM, Ms. Nancy Wichmann <<a href="mailto:nan_wich@bellsouth.net">nan_wich@bellsouth.net</a>> wrote:<br>
> Well, anyone with an account on DO may create documentation. It's an entirely volunteer effort. If you don't do it, who will?<br>
><br>
> Having said that, understand that there are many ways to do something in Drupal. And I have seen people dismiss as unusable what someone else thinks is great - but then don't offer their "better" solution. And galleries are one of those things that each person seems to take very personally.<br>
><br>
> Nancy<br>
><br>
> Injustice anywhere is a threat to justice everywhere. -- Dr. Martin L. King, Jr.<br>
><br>
> From: tony maciejowski<br>
><br>
> I must say it is incredibly frustrating to me that there is no decent documentation for a lot of things in Drupal. There is no where I can go to read step by step what I should do to set up a Gallery of images as<br>
><br>
> --<br>
> [ Drupal support list | <a href="http://lists.drupal.org/" target="_blank">http://lists.drupal.org/</a> ]<br>
><br>
><br>
><br>
> --<br>
> tony maciejowski | analyst/programmer | websites | <a href="mailto:tony@tony-mac.com">tony@tony-mac.com</a><br>
><br>
> Twitter: anntosh | Cell: <a href="tel:323.899.6206" value="+13238996206">323.899.6206</a> | Linked-In: Anthony Maciejowski<br>
><br>
><br>
><br>
><br>
</div></div>> --<br>
<div><div></div><div class="h5">> [ Drupal support list | <a href="http://lists.drupal.org/" target="_blank">http://lists.drupal.org/</a> ]<br>
<br>
--<br>
[ Drupal support list | <a href="http://lists.drupal.org/" target="_blank">http://lists.drupal.org/</a> ]<br>
</div></div></blockquote></div><br><br clear="all"><br>-- <br><p><b><font color="#333399" face="Arial" size="2"><span style="font-size:10.0pt;font-family:Arial;color:#333399;font-weight:bold">tony
maciejowski</span></font></b><b><font face="Arial" size="2"><span style="font-size:10.0pt;font-family:Arial;font-weight:bold"> <font color="black"><span style="color:black">|</span></font> <font color="#d1a73d"><span style="color:#D1A73D">analyst/programmer </span></font><span> </span><font color="black"><span style="color:black">|</span></font>
<font color="#00cc00"><span style="color:#00CC00">websites</span></font> <font color="black"><span style="color:black">|</span></font><font color="#FF0000"> <a href="mailto:t_maciejowski@hotmail.com" target="_blank"><font color="#FF0000" style="background-color:rgb(255, 255, 0)">tony@tony-mac.com</font></a></font> </span></font></b></p>
<p><font color="black" face="Arial" size="2"><span style="font-size:10.0pt;font-family:Arial;color:black"><b>Twitter: anntosh</b> | <b>Cell: 323.899.6206</b> | <b>Linked-In:</b> <b>Anthony Maciejowski</b> </span></font></p>
<p><font color="black" face="Arial" size="2"><span style="font-size:10.0pt;font-family:Arial;color:black"><span> </span></span></font></p><br>
</div>