generate proper documentation