updated documentation and specs