updated spec documentation to the latest spec