It could be a massive oversight from my end, but I'm not seeing any comprehensive development documentation anywhere at all. I have to know which functions are available to theme builders to call, which are future-safe and what do they do, etc. Classes, too.
I did find some articles, but all of them are guides. I can't find any dry & boring documentation that developers love.
For instance, I saw a function call in the basic theme: printHomeLink() with two arguments. I have no way of knowing what they are unless I dive into zenphoto's source. Or printAlbumDate() that is called with an empty string - what is that?
I don't need an answer to these quentions specifically, that's useless. What I (and all other devs) need, is a comprehensive overview of functions that we can use, and their arguments, and classes with their functions and arguments. Call it the API if you will. But right now, I'm developing completely blind, literally guessing at what sort of functions I can call, and pulling bits and pieces from examples and guides and forums. That's absolutely horrible to develop, if you'd pardon my nuancing there.
Is it missing, or is it just me?
Comments
And more specifically for themes:
http://www.zenphoto.org/documentation/functions/_template-functions.php.html
http://www.zenphoto.org/news/functions-documentation
There is also an introduction to the object model:
http://www.zenphoto.org/news/zenphotos-object-model-framework
There is also:
http://www.zenphoto.org/news/theming-tutorial (with linked example files on GitHub)
http://www.zenphoto.org/news/zenphotos-global-variables
http://www.zenphoto.org/news/an-overview-of-zenphoto-users
http://www.zenphoto.org/news/zenphoto-plugin-architecture (with linked example files on GitHub)