added more detail to docs