routes readme enhancements and vagrant integration