Most of the main, up to date Views docs are in the module itself as part of the "advanced help". There are notes all over the Views handbook pages, indicating that new docs should not be posted there, but instead integrated into the advanced help. Regardless, there is a ton of docs, tutorials, etc. in the handbook, and not every tutorial *should* even be in the adv help I would think.

We should clean up what is currently in the handbook into better organized sections, and then rewrite the disclaimer about what should be posted there and what should be patched into the Adv help (please consult merlinofchaos on this bit).

  • The main views module page http://drupal.org/handbook/modules/views is currently archived, and should be unarchived as the top level page of the section, since it is using the standard url path.
  • The rest of the section is here: http://drupal.org/node/109604
  • I would suggest a structure, something like:
    • Intro
      • Views 1
      • Views 2
    • Building
      • Views 1
      • Views 2
    • Theming
      • Views 1
      • Views 2
    • Tutorials
      • Views 1
      • Views 2
    • Developer API
      • Views 1
      • Views 2

Or something loosely resembling that.

Cross referencing this to issue #672920: Using Views to display only certain node types -- I think there is a way to do it (with code) in hopes that merlinofchaos will see it (I already ran this by emerald here as well: #233957: How to set up a category list), if he doesn't catch it in the next week or so, I will try and ping him in IRC just to make triply sure he's cool with this.

Comments

joachim’s picture

> not every tutorial *should* even be in the adv help I would think.

Agreed.

Furthermore, handbooks are a much easier way than CVS for people to collaborate on the documentation, by both copyediting and adding new material.

Subscribing, and wish I could help but so little time :(
Maybe sprint this at Copenhagen?

arianek’s picture

Totally, I am super busy at work, and also about to move house on Saturday, so I've had very little docs time lately. What time I've had I've been dedicating to the D7 core handbook docs, so I'm way behind in all respects! (And seemingly only 2 or 3 docs team members other than me are active even semi-regularly these days, I am at a loss for getting people back into it.)

Definitely good fodder for a CPH sprint - I will be coming over for it, so I'll see you there! :)

arianek’s picture

Priority: Normal » Major

also, bumping this up to major, as it's next in line after the core d7 stuff

Anonymous’s picture

I can help with this, I've been doing development with Views and I also have a video tutorial at http://www.youtube.com/watch?v=1z13ylwMhk4

arianek’s picture

hey lin!

that would be AWESOME. it's such a mess that any progress would be good progress. keep me posted if you manage to make some headway. thanks :)

Anonymous’s picture

Anonymous’s picture

There is also a great talk on Views for hackers taht should be incorporated into the documentation for devevlopers

thereisamoduleforthat.com/content/views-hackers-vandug

krina.addweb’s picture

Issue summary: View changes
quietone’s picture

Status: Active » Closed (outdated)

This is definitely outdated.