add missing and improve docs