[api] support the description of attribute definitions for real

It was there since the beginning, but never finished.
[api] set some default descriptions for the attribute type definitions.

Please, someone, review content and my language of them. Much appriciated!