bigpresh / Dancer-Plugin-Database

Dancer::Plugin::Database - easy database support for Dancer applications
http://search.cpan.org/dist/Dancer-Plugin-Database
37 stars 36 forks source link

Remove handler documentation #43

Open ambs opened 11 years ago

ambs commented 11 years ago

All the quick methods should be documented only in Dancer::Plugin::Database::Core::Handler. Dancer::Plugin::Database and Dancer2::Plugin::Database should only redirect the user. That way we do not need to release the plugins when a new handler feature is available.

bigpresh commented 8 years ago

Somehow I missed this until now (!).

I'm not certain I like this - I think briefly mentioning them, at least, is useful for someone reading over the doco for the plugins so they can see "ahh, and it gives me convenience stuff, I like the look of that" - I think perhaps retaining one simple example there would be useful.

I fully agree that the comprehensive documentation of all quick_* methods should be in the Handle class though.