better docs

@charlierudolph this is inspired by one of your comments. Please take a look!  :)
Yeah, because it does different things it has to be generic here. The description and step lists below shed more light onto this.