doc and spec updates based on review feedback