Ray has blogged about the initiative that CF team is taking to improve docs. Check – http://www.coldfusionjedi.com/index.cfm/2011/6/28/Initiative-to-improve-ColdFusion-docs