update documentation for more completeness