updating doc and specs