gem spec and more document updates