Maybe it's just me, but one of the things I find most confusing as I work
with web2py is figuring out what properties and methods each object has.
For example, I just learned that field.requires can have an options()
method that outputs a list of tuples for the options available in a
reference field. I really like the documentation in the web2py book because
it's oriented toward helping people actually build apps. But is there any
documentation of the data structure? I would find it enormously helpful to
have a "map" of the various objects returned by, say, DAL and SQLFORM,
listing all of their possible properties and methods. I know that this is
(in theory) available by simply reading the source code (that's how I
learned about the .options() method). But for those like myself who are not
full-time code gurus it would be a huge help to have this all a little more
accessible.
