[documentation] top pages, need some thought?

[Steven Peck]

Perhaps set a short definitive time/date for ending the discussion.  It needs help sooner then later.  It should be something that writers/marketers can really have some fun with.  

________________________________

From: documentation-bounces at drupal.org on behalf of Charlie Lowe
Sent: Wed 1/11/2006 9:15 AM
To: A list for documentation writers
Subject: Re: [documentation] top pages, need some thought?



I agree. There are problems with this page. But the problem is
indicative of the whole About section. It's more like a wikipedia of
various pages that are all filed in the same section rather than having
an overall rhetorical strategy which guides the crafting of all of the
pages and their organization.

Back in May, I posted a proposal for rethinking and restructuring this
section:

http://drupal.org/node/23106

I think I would revise this proposal a little now, but perhaps it would
be useful as a starting point for rethinking the About Drupal handbook.
Once we have an overall rhetorical strategy and organizational structure
for this handbook, then we would be in even a better position to know
what needs to go on each page.

Bèr Kessels wrote:
> Hi,
>
> I was reading http://drupal.org/node/22963 (is drupal right for you). And came
> to the conclusion that that part needs some love.
>
> One thing that bothers me most, is that one will conclude from that page, if
> anything can be concluded at all, that drupal is always right for the reader.
>
> Maybe we should add:
> * A summary with some user profiles of people who *can* use drupal
> * A summar of people who should *not* use drupal
> * A pointer to the services page explaining that certain people should not
> bother diving any deeper, but et somone to hold their hand, or do it for
> them.
>
> I beleive that that page, atm is telling nothing, really, while it ould be a
> very nice first "street map"  and gatekeeper for Drupal.
>
> Anyone willing to take this?
>
> Bèr
--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/



-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.drupal.org/pipermail/documentation/attachments/20060112/a74b3387/attachment-0001.htm