updated documentation and code/documentation alignment