spec doc updated