[documentation] Suggestions for re-documenting Drupal

[Kristof Van Tomme]

I added an issue and a drop task for this last week: more user
friendly interface to select parent page for book pages

http://drupal.org/node/233876
http://drop.cwgordon.com/node/71




On 20/03/2008, documentation-request at drupal.org
<documentation-request at drupal.org> wrote:
> Send documentation mailing list submissions to
>         documentation at drupal.org
>
>  To subscribe or unsubscribe via the World Wide Web, visit
>         http://lists.drupal.org/listinfo/documentation
>  or, via email, send a message with subject or body 'help' to
>         documentation-request at drupal.org
>
>  You can reach the person managing the list at
>         documentation-owner at drupal.org
>
>  When replying, please edit your Subject line so it is more specific
>  than "Re: Contents of documentation digest..."
>
>
>  Today's Topics:
>
>    1. Re: Suggestions for re-documenting Drupal (Addison Berry)
>    2. Re: Suggestions for re-documenting Drupal (Marjorie Roswell)
>
>
>  ----------------------------------------------------------------------
>
>  Message: 1
>  Date: Wed, 19 Mar 2008 21:40:17 -0400
>  From: Addison Berry <drupal at rocktreesky.com>
>  Subject: Re: [documentation] Suggestions for re-documenting Drupal
>  To: A list for documentation writers <documentation at drupal.org>
>  Message-ID: <77B04CF1-DB49-467E-BAF0-4162D71AC2B1 at rocktreesky.com>
>  Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes
>
>
>  On Mar 19, 2008, at 9:08 PM, Marjorie Roswell wrote:
>
>  > apologies for bad descriptive term!
>  >
>  > What's the best URL for continuing the conversation? Not quite sure
>  > where to go. (email's easiest for me, if some other location, let me
>  > know.)
>  Well the original issue for the points in it, but the conversation has
>  listed a bit form that so we should probably continue this discussion
>  here. :-)
>
>  >
>  >
>  > Honestly, I think the drop-down data entry form is a huge barrier to
>  > content entry, and as you noted, especially for new content entry...
>  > but most modules aren't in the documentation... so lots of room for
>  > new entries. Also, seems many things will require new pages for v6
>  > (or is that not accurate?)
>
>  Just because it is new content doesn't mean you need to use the
>  dropdown. I didn't say new content entry is a problem, because its not
>  unless you are creating a new top-level item or trying to move an item
>  from one place to a very different place. Both of those activites are
>  pretty rare on d.o which is why I said the dropdown is not an issue
>  99% of the time and typically the folks that do encounter it are d.o
>  site admins, not average docs team folks.
>
>  New content should be created with the Add child page link. You just
>  go the page that will be that parent for your new page and click the
>  Add child page link. That does the placement for you. E.g. if you
>  wanted to add a new module handbook page in the Event modules section,
>  just go to http://drupal.org/node/206786 (the Event modules page) and
>  click the Add child page right there. Easy peasy. You don't even need
>  to be on the docs team to do that. Everyone with a d.o account can add
>  child pages wherever, whenever they want.
>  >
>  > How does wikipedia handle spam? Honest question.
>
>  I don't know, I'm not that familiar with it other than reading
>  articles there.
>  >
>  >
>  > Margie
>
>
>
>  ------------------------------
>
>  Message: 2
>  Date: Wed, 19 Mar 2008 22:32:43 -0400
>  From: "Marjorie Roswell" <mroswell at gmail.com>
>  Subject: Re: [documentation] Suggestions for re-documenting Drupal
>  To: "A list for documentation writers" <documentation at drupal.org>
>  Message-ID:
>         <aa0037c80803191932k6bf19979v38547dd81e6112e4 at mail.gmail.com>
>  Content-Type: text/plain; charset="iso-8859-1"
>
>  I responded (favorably) to Larry's post at:
>
>  http://www.garfieldtech.com/drupal-org-wiki
>
>  I've since recorded a tiny little (15-second?) screencast to show what I
>  mean by the search drop-down ajaxy thing (based on civicrm search) that I
>  mentioned in the last paragraph. Might be  a good way to handle the
>  documentation dropdown piece.
>  http://screencast.com/t/qvGyH5TxRyt
>  -------------- next part --------------
>  An HTML attachment was scrubbed...
>  URL: http://lists.drupal.org/pipermail/documentation/attachments/20080319/3e497747/attachment-0001.htm
>
>  ------------------------------
>
>  _______________________________________________
>  documentation mailing list
>  documentation at drupal.org
>  http://lists.drupal.org/listinfo/documentation
>
>
>  End of documentation Digest, Vol 40, Issue 17
>  *********************************************
>