Use subsections in resource doc generation.
Use subsections in resource doc generation.

This allows any part of the resource type documentation
to be hyperlinked to.

Properties and attributes have also been moved above the syntax
examples.

Change-Id: Ie0fa2a1134be283a6c99ac2effcc869304d28f09

dragorosson/heat,takeshineshiro/heat,ntt-sic/heat,rh-s/heat,jasondunsmore/heat,ntt-sic/heat,pratikmallya/heat,citrix-openstack-build/heat,citrix-openstack-build/heat,miguelgrinberg/heat,noironetworks/heat,cwolferh/heat-scratch,miguelgrinberg/heat,takeshineshiro/heat,steveb/heat,openstack/heat,NeCTAR-RC/heat,pshchelo/heat,steveb/heat,rdo-management/heat,srznew/heat,redhat-openstack/heat,gonzolino/heat,cryptickp/heat,varunarya10/heat,dims/heat,varunarya10/heat,rickerc/heat_audit,rh-s/heat,dragorosson/heat,openstack/heat,dims/heat,pshchelo/heat,JioCloud/heat,srznew/heat,maestro-hybrid-cloud/heat,JioCloud/heat,NeCTAR-RC/heat,cwolferh/heat-scratch,gonzolino/heat,jasondunsmore/heat,redhat-openstack/heat,rdo-management/heat,maestro-hybrid-cloud/heat,noironetworks/heat,cryptickp/heat,pratikmallya/heat,rickerc/heat_audit