Oh wait, I can't even say that because it would be a compliment this basically non-existent documentation does not deserve.

I just spent over 4 hours on trying to find out what the thing I want to add is even called and how to implement it.
I did not have any meaningful modicum of success.

First I looked around for an overview that would give me the general gist of the module and its terminology.
There isn't any. At least not 'easily findable' in any definition of the term.

The README-file is totally useless for this purpose as well. The 'documentation' told me to use the advanced help and just click on shiny question mark buttons. I did that, and since then am about 30% sure that what I want to add is called an 'area'.

I looked at https://api.drupal.org/api/views and found https://api.drupal.org/api/views/handlers%21views_handler_area.inc/group...

So if I really need an area I have to define an area-handler class. I think…?
But nowhere does it tell me how to register an area handler or how to implement one.

So then I watched a talk or screencast or whatever you call those damned things. (Whoever came up with the notion that a "video tutorial" is better than a readable, searchable documentation was clearly retarded, so I decided not to demand painful correctional treatment, but went for quiet loathing instead).

After about an hour of listening to some guy with bad pronounciation go "uuh, uuuh, uhhh" in real shitty audio and even shittier video, I was none the wiser.

I also asked, considerably nicer than this, in #drupal-views and #drupal if anyone could tell me even what the thing I want to add is called. Predictable, I got exactly 0 responses.

So dear Views developers,

please, please, PLEASE, for everything that keeps a developer sane - DOCUMENT YOUR SHIT!

Comments

phryk’s picture

While I still don't have any clue if an area is what I want, I have found this:

http://views-help.doc.logrus.com/help/views/api-handler-area

The thing is, the link to views-help.doc.logrus.com is only listed for Views-2, so I have no clue if this even works with API version 3.
If this is current, by Eris, put it at a *prominent* place on the project page and make sure to mention that this is the current.

dawehner’s picture

Please calm down, there are just 24hrs a day, people have freetime activies and more important you get stuff for free.
I don't disagree that documentation could be made way better.
You should better invest your energy and improve the documentation.

So here is a thing: Open your views folder, go to the helper folder and you will have a couple of html files (the same as on views-help.doc.logrus.com)
Oh wonder oh wonder you will find api-handler-area. I am glad that you never actually opened up the readme.

Welcome to Views 3. Please see the advanced help for more information.

If you don't know what advanced help stands for, google it and you see what I mean.

After about an hour of listening to some guy with bad pronounciation go "uuh, uuuh, uhhh" in real shitty audio and even shittier video, I was none the wiser.

Yeah people pretty much suck, I do agree.

please, please, PLEASE, for everything that keeps a developer sane - DOCUMENT YOUR SHIT!

Given that area handlers are a concept of views 3 http://views-help.doc.logrus.com/help/views/api-handler-area is pretty fine.

gagarine’s picture

Priority: Critical » Normal
Issue summary: View changes
Webbeh’s picture

Status: Active » Closed (outdated)

I think we can safely say this issue has been resolved, or at least doesn't meet the level of concern raised by the OP.

Webbeh’s picture

Assigned: Unassigned » Webbeh

And for future reference, assigning myself to this for any updates.