Voting Disabled

Rank26

Idea#64

Active
Drupal.org »

Separate Drupal Documentation by Version

As a complete newbie, one of the most confusing things is to be reading documentation explicitly for drupal 7 and follow a link to a page which is only for drupal 6.

Also. I have not found any quick start guides so I am in the process of writing an extensive one, which I will post after I have succeeded in getting my first three sites up and running.

Submitted by gh 2 years ago

Comments [10]

  1. I can't undo my downvote :(

    The decision to keep all versions of documentation together is deliberate. If there were separate versions, it would be a lot of duplicate content and 2x (3x?) as much work to maintain, and there aren't enough documentation volunteers to manage this.

    You point out the problem that you aren't informed when you move from one node to another. It would be interesting to discuss solutions around that. There's a section available on every docs page called "About this page".... if that info isn't filled in, anyone can fix it.

    2 years ago
    0 Agreed
    0 Disagreed
    1. gh Idea Submitter

      Separate can be a verb or an adjective in the subject ;-).

      2 years ago
      0 Agreed
      0 Disagreed
    2. An idea: let the menu system hide links to content not tagged with the version you're interested in? Is that possible while browsing (as opposed to when searching)?

      2 years ago
      0 Agreed
      0 Disagreed
  2. I think what could be used here is 'per version' indexes, so that one could filter out a specific drupal version when searching for documentation ... think 'version specific' table of contents, or the ability to filter out specific versions while viewing the documentation hierarchy tree ... but in a way that wouldn't require duplication of the actual documentation itself.

    2 years ago
    1 Agreed
    0 Disagreed
    1. Just created a topic about the very thing, before seeing this. Would be good to filter by version when searching. Adding a version tag to the docs and forum content types should be mandatory (required) to make this work.

      2 years ago
      0 Agreed
      0 Disagreed
  3. gh Idea Submitter

    I anticipated Lisa's comment, which is why I did not actually propose anything specific ;-). I will never use v6 so my guide will be only for v7. The way the projects are documented is really good. There are links to releases on the front page and one can readily tell what the support status is. The problem for a newbie is knowing where to look.

    I have now learned to scan every page I am reading for anything version specific before I start. Jthorson's idea could be developed a little further to 'per version' filters ... but the UI might become a nightmare, so I don't know.

    2 years ago
    0 Agreed
    0 Disagreed
  4. :) gh, I agree it's a definite problem that it can be difficult to use docs that have various things that are applicable, and others that aren't.

    If the content in a node was marked up so that version specific stuff was identified, I wonder what it would take to allow people to click a setting to filter out the irrelevant content, e.g. 'only show D7-related content'.

    2 years ago
    1 Agreed
    0 Disagreed
    1. That would be awesome! There is another idea about incorporating VBO in module pages, but the same would be great for docs.

      2 years ago
      0 Agreed
      0 Disagreed
  5. Often though docs and solutions are bundled up for more than one version on a single node. The very helpfull comments of "Here's how do do the same thing but in Drupal 7" are quite popular.

    Also often, reading docs for d6 can help solve a problem in D7. It will be difficult to incorporate that into tagging.

    I usually rely on post/comment dates to get an idea as to which version the discussion pertains and find that it's quite a good indicator.

    2 years ago
    0 Agreed
    0 Disagreed
  6. I think this would just create extra work. That's why there's the "You can edit this page." link. It keeps the document fresh, as long as the community helps out.

    2 years ago
    0 Agreed
    0 Disagreed

Vote Activity [ 20 ] [+]

(latest 20 votes)

Events [ 1 ] [+]