a few updates on documentation