Fix resources descriptions for custom guidelines

There're several errors, raised by custom guidelines check,
need to fix it for successful pep8 running.

implements bp custom-guidelines

Change-Id: Ibef41cad9b20715a740cedac7b98e9647bd3d6b7

heat/engine/resources/openstack/cinder/volume.py

@@ -643,6 +643,11 @@ class CinderVolume(vb.BaseVolume, sh.SchedulerHintsMixin):
 
 
 class CinderVolumeAttachment(vb.BaseVolumeAttachment):
+    """Resource for associating volume to instance.
+
+    Resource for associating existing volume to instance. Also, the location
+    where the volume is exposed on the instance can be specified.
+    """
 
     PROPERTIES = (
         INSTANCE_ID, VOLUME_ID, DEVICE,

heat/engine/resources/openstack/heat/structured_config.py

@@ -184,6 +184,11 @@ class StructuredDeployment(sd.SoftwareDeployment):
 
 
 class StructuredDeploymentGroup(sd.SoftwareDeploymentGroup):
+    """This resource associates a group of servers with some configuration.
+
+    This resource works similar as OS::Heat::SoftwareDeploymentGroup, but for
+    structured resources.
+    """
 
     PROPERTIES = (
         SERVERS,

heat/engine/resources/openstack/keystone/role_assignments.py

@@ -312,7 +312,10 @@ class KeystoneRoleAssignmentMixin(object):
 
 class KeystoneUserRoleAssignment(resource.Resource,
                                  KeystoneRoleAssignmentMixin):
-    """Resource for granting roles to a user."""
+    """Resource for granting roles to a user.
+
+    Resource for specifying users and their's roles.
+    """
 
     support_status = support.SupportStatus(
         version='5.0.0',
@@ -363,7 +366,10 @@ class KeystoneUserRoleAssignment(resource.Resource,
 
 class KeystoneGroupRoleAssignment(resource.Resource,
                                   KeystoneRoleAssignmentMixin):
-    """Resource for granting roles to a group."""
+    """Resource for granting roles to a group.
+
+    Resource for specifying groups and their's roles.
+    """
 
     support_status = support.SupportStatus(
         version='5.0.0',

heat/engine/resources/openstack/neutron/extraroute.py

@@ -23,6 +23,10 @@ from heat.engine import support
 
 
 class ExtraRoute(neutron.NeutronResource):
+    """Resource for specifying extra routes for Neutron router.
+
+    Resource allows to specify nexthop IP and destination network for router.
+    """
 
     required_service_extension = 'extraroute'
 

heat/engine/resources/openstack/nova/floatingip.py

@@ -107,7 +107,10 @@ class NovaFloatingIp(resource.Resource):
 
 
 class NovaFloatingIpAssociation(resource.Resource):
-    """A resource associates Nova floating IP with Nova server resource."""
+    """A resource associates Nova floating IP with Nova server resource.
+
+    Resource for associating existing Nova floating IP and Nova server.
+    """
 
     support_status = support.SupportStatus(version='2014.1')
 

tools/custom_guidelines.py

@@ -53,7 +53,7 @@ class HeatCustomGuidelines(object):
     def check_resource_descriptions(self):
         for cls in self.resources_classes:
             # check resource's description
-            #self._check_resource_description(cls)
+            self._check_resource_description(cls)
             # check properties' descriptions
             self._check_resource_schemas(cls, cls.properties_schema,
                                          'property')