Docs are showing deprecated API's

http://docs.vmd.citrix.com/XenServer/6.5.0/1.0/en_gb/api/?c=VM_metrics shows that e.g. VCPU utilisation is available. However as I understand it, this is deprecated. It would be nice to include that in the docs.