more works in progress
automated docs