Redesigning Drupal documentation

Events happening in the community are now at Drupal community events on www.drupal.org.
Amazon's picture

Steven Peck, head of the Drupal documentation team has suggested a redesign. I am going to suggest that we attempt to implement this redesign using the new book module in Drupal 6 in Barcelona. Let me know if you are interested in doing this either during the session or remotely.

  • Getting Started *
  • Project and features
  • Before you start
  • Drupal 6
    +- Installation etc
  • Drupal 5
    • Installation etc
  • Drupal 4.7
    • This will contain many of the older pages that aren't getting unpublished.
      -Concepts
    • Collected articles etc.
  • HowTos and Snippets*

  • HowTos
    • The advanced user guide
    • Site recipes
    • Theme tutorials
    • Contrib module HowTos
  • Snippets (partial solutions, bits and pieces)
    • Introduction to the concept / use / risks
    • PHP Snippets
    • PHP Template Snippets
    • Contributed modules
  • Videocasts

  • Theme developers guide *
    -Theming overview - introduce things.

    • Engines overview engines with a lean towards phptemplate
  • I get fuzzy on the details after this part. There aare differences
    between 4.7-5.0 and 6.0. dvessel is actually writing theme docs for
    D6 right now separately so we have a start right there for some what
    versioned docs. How to integrate them in a sane manner still needs
    some thought and response.

  • Developing for Drupal *
    Currently I am not planning on touching this yet. I do have some
    ideas on it but just re-organizing two and integrating a third is
    enough initial scope. There are two main areas in this book though.
    One is module development, the other is drupal.org project use and
    maintenance of projects/cvs/etc. So it may be good to give it some
    thought for later.

  • Drupal Site Resources * or some such inclusive title.
    This pulls in the stuff that was in About Drupal.
    The About Drupal documentation goes in.