Add documentation for per-framework metrics flag.
Add documentation for per-framework metrics flag.

Review: https://reviews.apache.org/r/68957/

chhsia0/mesos,dforsyth/mesos,dforsyth/mesos,reneploetz/mesos,gsantovena/mesos,jpeach/mesos,jpeach/mesos,dforsyth/mesos,Gilbert88/mesos,kaysoky/mesos,chhsia0/mesos,gsantovena/mesos,reneploetz/mesos,gsantovena/mesos,chhsia0/mesos,chhsia0/mesos,jpeach/mesos,Gilbert88/mesos,abudnik/mesos,kaysoky/mesos,dforsyth/mesos,reneploetz/mesos,jpeach/mesos,chhsia0/mesos,abudnik/mesos,Gilbert88/mesos,Gilbert88/mesos,reneploetz/mesos,gsantovena/mesos,jpeach/mesos,abudnik/mesos,chhsia0/mesos,dforsyth/mesos,chhsia0/mesos,kaysoky/mesos,abudnik/mesos,Gilbert88/mesos,reneploetz/mesos,jpeach/mesos,abudnik/mesos,Gilbert88/mesos,reneploetz/mesos,kaysoky/mesos,kaysoky/mesos,gsantovena/mesos,kaysoky/mesos,jpeach/mesos,gsantovena/mesos,kaysoky/mesos,reneploetz/mesos,gsantovena/mesos,abudnik/mesos,abudnik/mesos,dforsyth/mesos,Gilbert88/mesos,dforsyth/mesos