update documentation to lists