flesh out some doc strings