extend metrics documentation and outline of what should be included