detail text updates
some doc changes
updated after feedback from @ctrlbreak