Improved documentation and found the reason behind test failures