improved the documentation

@jacobawenger do you mind looking over the doc changes? thanks!