Comment by kmcquade

Great feedback! I will update the docs accordingly.