adding more detail to the docs