documented some things