some doc and spec clean up