WordPress: “Too cool for documentation”
I’m pissed off.
I’m trying to write a sidebar widget for the new WordPress. It’s a really simple widget, in fact it only has one option. Since widgets are part of WordPress now, naturally I thought – as the premier blogging platform, that I’d find some well-written API documentation on the codex detailing how to go about interfacing with the dynamic sidebar and admin section.
Yeah I was wrong.
I defy anyone to write a sidebar widget that works with the built-in widgets UIs using the information on these websites. I reckon you can get close but there’s bits of information missing about the admin panel. Apparently there’s some Google Search widget that you can look at that’s well-commented but I can’t find that anywhere within my WordPress source tree.
Don’t get me wrong, I love the laid-back “cool Web 2.0″ style but there are boundaries. And saying API Documentation is “for eggheads” is a bit childish, honestly.