docs

cc @calvinfo 
nit: providing