improve doc generator, introduce verbose_description property