[drupal-docs] Top 20 searches for documentation

[Matt Simpson]

I'll make ya a deal... point me to A) the material that explains how to do
this, and B) a wiki where I can author a version of it from a non-developer
point of view (I can implement it if you don't have it)... and then work
with me to correct what I can't figure out, and correct what I write.  I'll
document what I learn as I go through it.

You say that you are looking to consilidate best practices.  My fear is that
the currently-authored practices are so cryptic that only developers
understand them... So, someone with non-developer knowledge fundamentally
isn't able to author something for other non-developers, simply because they
don't understand what to do.  (of course my fear is that I'm speaking of
myself)

It's a catch 22.  Non-developer admins need very simple writing in order to
understand what to do.  This is knowledge passed along from the developers.
However, developers can no longer understand the way mere mortals think
because they have achieve technical enlightenment.  When there is a need to
write something for non-developers, it takes a non-developer to write it.
However, in order for a non-developer to know what to write, there has to be
some source of knowledge (e.g. something written).  Yet, if there was
something written that a non-developer could understand, then there would be
no need to write something for non-developers.

-- Matt

----- Original Message ----- 
From: "Kieran Lal" <kieran at civicspacelabs.org>
To: <drupal-docs at drupal.org>
Cc: "Carlos Miranda Levy" <carlos at educar.org>
Sent: Monday, March 28, 2005 11:07 AM
Subject: Re: [drupal-docs] Top 20 searches for documentation


> I know of three people who have written about this.
>
> Carlos Miranda Levy wrote a blog post at CivicSpaceLabs.org.
> Aldon Hayes posted a blog and refered to it in the CivicSpace forums.
> Josh Koenig has recently made proposal for how to do state sites on the
> CivicSpace forums.
>
> This is a big topic and I have been looking for someone to consolidate
> best practices.  Interested?
>
> Cheers,
> Kieran
> On Mar 28, 2005, at 7:27 AM, Matt Simpson wrote:
>
> > For example... I'm trying to figure out how to setup multiple domains
> > using
> > multiple databases and am reading http://drupal.org/node/278 but can't
> > understand it.  What goes where?  If exampledomain.com is the base
> > installation, what do I put there to support subdomains?  What do I
> > put on
> > subdomain-one.exampledomain.com?  The authors who wrote
> > http://drupal.org/node/278 assume that something is known.  The only
> > people
> > who have commented there are those who know that magical thing that was
> > assumed.  Is there somewhere else that this is better documented?
> >
> > Matt
> >
> > ----- Original Message -----
> > From: "Anisa" <mystavash at animecards.org>
> > To: <drupal-docs at drupal.org>
> > Sent: Monday, March 28, 2005 6:57 AM
> > Subject: Re: [drupal-docs] Top 20 searches for documentation
> >
> >
> >> Actually...  what about getting some guinea pigs?  Get them to go
> >> through making a drupal site, and contact us when they can't find what
> >> they're looking for in the handbook or search.
> >>
> >> Anisa.
> >> a scientist's daughter...  ;)
> >>
> >> Kieran Lal wrote:
> >>
> >>> Hi, I don't have time to do it right now, but it would be good if
> >>> someone could come up with a list of the top twenty things they
> >>> believe people want in documentation.  We should then have a script
> >>> to
> >>> run the searches to see how well the documentation shows up in the
> >>> answers.  The documentation may be there, but people can't find it.
> >>>
> >>> Cheers,
> >>> Kieran
> >>>
> >> -- 
> >> [ drupal-docs | http://lists.drupal.org/listinfo/drupal-docs ]
> >>
> >
> >
> > -- 
> > [ drupal-docs | http://lists.drupal.org/listinfo/drupal-docs ]
> >
>
> -- 
> [ drupal-docs | http://lists.drupal.org/listinfo/drupal-docs ]
>