updated docs, and descriptions