Yes it's an area that can be greatly improved
http://api.kde.org/frameworks-api/frameworks5-apidocs/plasma-framework/html/index.html is the most useful for Plasma specific parts.
>> Visit http://mail.kde.org/mailman/listinfo/kde-devel#unsub to unsubscribe <<