[documentation] [Documentation task] Drupal page snippets categorization

[pwolanin]

Issue status update for 
http://drupal.org/node/87589
Post a follow up: 
http://drupal.org/project/comments/add/87589

 Project:      Documentation
 Version:      <none>
 Component:    User Guide
 Category:     tasks
 Priority:     normal
 Assigned to:  Anonymous
 Reported by:  levavie
 Updated by:   pwolanin
 Status:       active

I did my best to reorganize the page snippets by Drupal version.  Some I
left at the top level that seem version independent or are general (e.g.
"how to use a snippet").   I tried to categorize them with appropriate
taxonomy terms and add the "notice" at the top to most.


Maybe adding the page for Drupal 5.x was hasty...


An outstanding issue now seems to be removing the comments on the top
page or making them their own snippets:  http://drupal.org/node/23220




pwolanin



Previous comments:
------------------------------------------------------------------------

Thu, 05 Oct 2006 11:17:48 +0000 : levavie

The list of drupal page snippets [1] (and other snippets) have grown
wild. But essential  information is missing. No mention of the author,
the date submitted, the applicable drupal version, and more. It is
already too large to manage. 


Suggested solutions: Is it possible to make it CCK? to order it by
drupal version? By required components which are needed by the snippet? 


Amnon
-
Personal: Bring Dolphin's Simple Joy to your Work - Job - Career
Professional: Drupal Hebrew Consulting [2] 


[1] http://drupal.org/node/23220
[2] http://www.levavie.com




------------------------------------------------------------------------

Thu, 05 Oct 2006 13:17:07 +0000 : pwolanin

responsible authors should tag with the taxonomy term form the relevant
version, though many should be edited and tagged.  Many authors at least
put version info in the comments.  Seems like a starting point is to
check these all for version tagging, and then reorganize them to 3 child
pages for Drupal 4.5/4.6, 4.7, and 5.0.




------------------------------------------------------------------------

Thu, 05 Oct 2006 13:51:44 +0000 : pwolanin

ok- I started this reorganization.  Everyone should feel free to pitch
in (Drupal.org is running really slow today, I think).




------------------------------------------------------------------------

Thu, 05 Oct 2006 14:19:37 +0000 : Dublin Drupaller

Hi guys,


I like the idea of snippet categorisation..but i think it's a bad idea
to house snippets in the handbook.


http://drupal.org/node/87611#comment-160351


Dub




------------------------------------------------------------------------

Thu, 05 Oct 2006 17:08:20 +0000 : pwolanin

I don't have any strong feeling about where these should be located-
however there needs to be a low barrier for people posting them, and
they need to be easy to find.  Also, I think there is potentially some
benefit to providing an opportunity for people to make their first
handbook post in the hopes that they will make more and more substantial
ones later.


What would you suggest as an alternative to the handbook?




------------------------------------------------------------------------

Thu, 05 Oct 2006 19:07:44 +0000 : laura s

+1 for some sort of reorganization. Having mystery tags that are not
visible until you're actually looking at the page is very awkward. A
while ago I proposed exploring some sort of methodology for clarifying
our handbooks architecture, but it got no response. Still, I feel that
until we figure a way to have handbook navigation by release number (I
don't believe it would be practical to actually duplicate the pages
themselves, but the nav blocks could be restricted to taxonomy term,
no?), we're going to me mired in big mosh piles of vaguely related
content.


+1 for the CCK idea. This could add some structure to the area, with
fields for Title, Author, description, code, additional remarks.


+1 for splitting the snippets out to their own book, too, if it would
help. As long as they're findable, to me it doesn't matter where they're
stowed.


Laura




------------------------------------------------------------------------

Thu, 05 Oct 2006 19:13:43 +0000 : chx

-1 for CCK on drupal.org . The problem is that every module that gets on
drupal needs a very strict security review and I can't see the people
doing this unless there is an overwhelming benefit which justfifies this
big work.




------------------------------------------------------------------------

Thu, 05 Oct 2006 21:58:00 +0000 : sepeck

Dub, could you please move your comment to this issue and delete the
comment from the handbook?  As to snippets in the handbook you are the
one that convinced me it was a good idea earlier this year.  It has been
a huge success with lots of peopl eadding and mining for ideas and
solutions that they can tailer to their needs.


I'll look some more this weekend.