Improve Comparison documentation compliance with Yardstick rules.
Improve Comparison documentation compliance with Yardstick rules.

ar-dm/ardm-core,alloy/dm-core,datamapper/dm-core,tillsc/dm-core,engineyard/dm-core,tpitale/dm-core