[documentation] Videos for Drupal 6

[Lee Hunter]

Hi Greg,

I like your suggestion. I wonder if "Getting Started With Drupal X"  or
"Drupal X Video Quickstarts" would work better as a top level.
"Introduction" doesn't sound like it's going to cover the installation and
upgrading tasks.

The video section suffers from the same problem as much of  the rest of the
Drupal documentation in that unrelated content tends to get jumbled together
within arbitrary and opaque containers. For example, there's a "Training
Videos for Beginners (English) which, despite the heading, covers just about
anything and everything up to and including some fairly advanced topics.

It would be great to have content organized by what the reader wants to
achieve (e.g. Creating new content types) rather than by what makes sense to
project insiders. For example, headings like Core Configuration and  Modules
might make sense from the inside but it doesn't give the reader much of a
clue as to what sort of  issues will be tackled.

If the whole doc section was restructured by task-based topics, it might
even make sense to do away with a separate video section and place each
video within the context of relevant text-based content. In other words, the
reader who is looking for information on creating new content types should
be able to see at a glance ALL the available guidance about creating content
types whether it involves core or contributed modules, video or text.

Lee H.

On Jan 28, 2008 2:10 PM, Greg Knaddison - GVS <
Greg at growingventuresolutions.com> wrote:

> Howdy Documenters,
>
> I have two topics I want to discuss.  First - organization of the
> Videocasts section of the D.o handbooks - http://drupal.org/videocasts
>
> I think it would make sense to re-organize this by major release of
> Drupal.  I.e. a top level page for 5.x, 6.x, and 4.7 and earlier.
> Gabor and I discussed this in IRC today as a way to help make it easy
> to find the 6.x videos that will be linked form the 6.0 release
> announcement ( http://drupal.org/drupal-6.0 if you want to help
> editing it).  Some of the pages in that section are "timeless" like
> how to create or apply a patch - that is valuable regardless of Drupal
> version.  But some are very specific to version (upgrading) which
> makes me think that we should split the version specific videos into
> book pages for each version and then "general videos" will stay at
> their current locations.
>
> Here's the current hierarchy:
>
> -Videos
>
> -- Overviews
> --- New Features in Drupal6
> --- New i18n and l10n features in Drupal 6
> --- Drupal 5 Features
> --- What's new in Drupal 5
> --- Drupal Features and Overview
>
> -- Installation and Upgrading
> --- Installing Drupal 6
> --- Installing Drupal 5
> --- Upgrading to Drupal 5
> --- Dudertown Installing 4.7
> --- Installing Drupal 4.7
>
> My proposed hierarchy:
>
> -- Introduction to Drupal6
> --- New Features in Drupal6
> --- New i18n and l10n features in Drupal 6
> --- Installing Drupal 6
> --- Upgrading to Drupal6
>
> -- Introduction to Drupal5
> --- Drupal 5 Features
> --- What's new in Drupal 5
> --- Installing Drupal 5
> --- Upgrading to Drupal 5
>
> -- Introduction to Drupal4.7
> --- Dudertown Installing 4.7
> --- Installing Drupal 4.7
>
> The rest of the handbooks are less complete on a "per version" basis
> and I think should be left as-is.  There's also less that changes
> about, for example, blocks from 4.7->5.x->6.x
>
> Second, I want to coordinate on making sure that we get them all done.
> 1. Installing Drupal6 - done by Addi -
> http://www.lullabot.com/videocasts/installing-drupal-6
> 2. New features of Drupal6 - done by me (will redo this week) -
> http://www.masteringdrupal.com/screencast/new-features-drupal-6
> 3. i18n and l10n features of Drupal6 - done by me -
> http://www.masteringdrupal.com/screencast/new-i18n-l10n-features-drupal-6
> 4. Upgrading from Drupal 5.x to 6.x - I believe I will be doing this one
> 5. Anything else specific to the release?
>
> I know there are plenty of other ideas related to videos for Drupal in
> general - I'm just trying to make sure we've covered the most
> important videos for the new release process.
>
> Thanks,
> Greg
>
> --
> Greg Knaddison
> Denver, CO | http://knaddison.com
> World Spanish Tour | http://wanderlusting.org/user/greg
> --
> 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/20080128/020f5d9e/attachment.htm