updates documentation

Updates documentation to provide adopters with concrete steps in getting setup.

cc @bess @waynegraham