document things some more