[documentation] [Documentation task] Drupal page snippets categorization

[laura s]

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:   laura s
 Status:       active

+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




laura s



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?