PROD-365 - doc coverage

boom
if deprecating, suggest what to use instead?