Update documentation with better install/setup instructions

Addresses BIT-1160
Merge remote-tracking branch 'origin/topic/dnthayer/ticket1160'

* origin/topic/dnthayer/ticket1160:
  Update documentation with better install/setup instructions

BIT-1160 #merged