diff --git a/amazonka-elb.cabal b/amazonka-elb.cabal
--- a/amazonka-elb.cabal
+++ b/amazonka-elb.cabal
@@ -1,5 +1,5 @@
 name:                  amazonka-elb
-version:               0.3.4
+version:               0.3.5
 synopsis:              Amazon Elastic Load Balancing SDK.
 homepage:              https://github.com/brendanhay/amazonka
 license:               OtherLicense
@@ -70,5 +70,5 @@
     other-modules:
 
     build-depends:
-          amazonka-core == 0.3.4.*
+          amazonka-core == 0.3.5.*
         , base          >= 4.7     && < 5
diff --git a/gen/Network/AWS/ELB/AddTags.hs b/gen/Network/AWS/ELB/AddTags.hs
--- a/gen/Network/AWS/ELB/AddTags.hs
+++ b/gen/Network/AWS/ELB/AddTags.hs
@@ -22,12 +22,11 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Adds one or more tags for the specified load balancer. Each load balancer can
--- have a maximum of 10 tags. Each tag consists of a key and an optional value.
+-- | Adds the specified tags to the specified load balancer. Each load balancer
+-- can have a maximum of 10 tags.
 --
--- Tag keys must be unique for each load balancer. If a tag with the same key
--- is already associated with the load balancer, this action will update the
--- value of the key.
+-- Each tag consists of a key and an optional value. If a tag with the same key
+-- is already associated with the load balancer, 'AddTags' updates its value.
 --
 -- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/TerminologyandKeyConcepts.html#tagging-elb Tagging> in the /Elastic Load Balancing DeveloperGuide/.
 --
@@ -73,14 +72,13 @@
     , _atLoadBalancerNames = mempty
     }
 
--- | The name of the load balancer to tag. You can specify a maximum of one load
--- balancer name.
+-- | The name of the load balancer. You can specify one load balancer only.
 atLoadBalancerNames :: Lens' AddTags [Text]
 atLoadBalancerNames =
     lens _atLoadBalancerNames (\s a -> s { _atLoadBalancerNames = a })
         . _List
 
--- | A list of tags for each load balancer.
+-- | The tags.
 atTags :: Lens' AddTags (NonEmpty Tag)
 atTags = lens _atTags (\s a -> s { _atTags = a }) . _List1
 
diff --git a/gen/Network/AWS/ELB/ApplySecurityGroupsToLoadBalancer.hs b/gen/Network/AWS/ELB/ApplySecurityGroupsToLoadBalancer.hs
--- a/gen/Network/AWS/ELB/ApplySecurityGroupsToLoadBalancer.hs
+++ b/gen/Network/AWS/ELB/ApplySecurityGroupsToLoadBalancer.hs
@@ -22,11 +22,11 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Associates one or more security groups with your load balancer in Amazon
--- Virtual Private Cloud (Amazon VPC). The provided security group IDs will
--- override any currently applied security groups.
+-- | Associates one or more security groups with your load balancer in a virtual
+-- private cloud (VPC). The specified security groups override the previously
+-- associated security groups.
 --
--- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/USVPC_ApplySG.html Manage Security Groups in Amazon VPC> in the /Elastic Load Balancing Developer Guide/.
+-- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/USVPC_ApplySG.html Manage Security Groups for Amazon VPC> in the /Elastic Load Balancing Developer Guide/.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_ApplySecurityGroupsToLoadBalancer.html>
 module Network.AWS.ELB.ApplySecurityGroupsToLoadBalancer
@@ -72,15 +72,13 @@
     , _asgtlbSecurityGroups   = mempty
     }
 
--- | The name associated with the load balancer. The name must be unique within
--- the set of load balancers associated with your AWS account.
+-- | The name of the load balancer.
 asgtlbLoadBalancerName :: Lens' ApplySecurityGroupsToLoadBalancer Text
 asgtlbLoadBalancerName =
     lens _asgtlbLoadBalancerName (\s a -> s { _asgtlbLoadBalancerName = a })
 
--- | A list of security group IDs to associate with your load balancer in VPC.
--- The security group IDs must be provided as the ID and not the security group
--- name (For example, sg-1234).
+-- | The IDs of the security groups to associate with the load balancer. Note that
+-- you cannot specify the name of the security group.
 asgtlbSecurityGroups :: Lens' ApplySecurityGroupsToLoadBalancer [Text]
 asgtlbSecurityGroups =
     lens _asgtlbSecurityGroups (\s a -> s { _asgtlbSecurityGroups = a })
@@ -107,7 +105,7 @@
     { _asgtlbrSecurityGroups = mempty
     }
 
--- | A list of security group IDs associated with your load balancer.
+-- | The IDs of the security groups associated with the load balancer.
 asgtlbrSecurityGroups :: Lens' ApplySecurityGroupsToLoadBalancerResponse [Text]
 asgtlbrSecurityGroups =
     lens _asgtlbrSecurityGroups (\s a -> s { _asgtlbrSecurityGroups = a })
diff --git a/gen/Network/AWS/ELB/AttachLoadBalancerToSubnets.hs b/gen/Network/AWS/ELB/AttachLoadBalancerToSubnets.hs
--- a/gen/Network/AWS/ELB/AttachLoadBalancerToSubnets.hs
+++ b/gen/Network/AWS/ELB/AttachLoadBalancerToSubnets.hs
@@ -22,12 +22,11 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Adds one or more subnets to the set of configured subnets in the Amazon
--- Virtual Private Cloud (Amazon VPC) for the load balancer.
+-- | Adds one or more subnets to the set of configured subnets for the specified
+-- load balancer.
 --
--- The load balancers evenly distribute requests across all of the registered
--- subnets. For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/UserScenariosForVPC.html Deploy Elastic Load Balancing in Amazon VPC>
--- in the /Elastic Load Balancing Developer Guide/.
+-- The load balancer evenly distributes requests across all registered subnets.
+-- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/UserScenariosForVPC.html Elastic Load Balancing in Amazon VPC> in the /ElasticLoad Balancing Developer Guide/.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_AttachLoadBalancerToSubnets.html>
 module Network.AWS.ELB.AttachLoadBalancerToSubnets
@@ -73,13 +72,12 @@
     , _albtsSubnets          = mempty
     }
 
--- | The name associated with the load balancer. The name must be unique within
--- the set of load balancers associated with your AWS account.
+-- | The name of the load balancer.
 albtsLoadBalancerName :: Lens' AttachLoadBalancerToSubnets Text
 albtsLoadBalancerName =
     lens _albtsLoadBalancerName (\s a -> s { _albtsLoadBalancerName = a })
 
--- | A list of subnet IDs to add for the load balancer. You can add only one
+-- | The IDs of the subnets to add for the load balancer. You can add only one
 -- subnet per Availability Zone.
 albtsSubnets :: Lens' AttachLoadBalancerToSubnets [Text]
 albtsSubnets = lens _albtsSubnets (\s a -> s { _albtsSubnets = a }) . _List
@@ -105,7 +103,7 @@
     { _albtsrSubnets = mempty
     }
 
--- | A list of subnet IDs attached to the load balancer.
+-- | The IDs of the subnets attached to the load balancer.
 albtsrSubnets :: Lens' AttachLoadBalancerToSubnetsResponse [Text]
 albtsrSubnets = lens _albtsrSubnets (\s a -> s { _albtsrSubnets = a }) . _List
 
diff --git a/gen/Network/AWS/ELB/ConfigureHealthCheck.hs b/gen/Network/AWS/ELB/ConfigureHealthCheck.hs
--- a/gen/Network/AWS/ELB/ConfigureHealthCheck.hs
+++ b/gen/Network/AWS/ELB/ConfigureHealthCheck.hs
@@ -22,10 +22,10 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Specifies the health check settings to use for evaluating the health state
+-- | Specifies the health check settings to use when evaluating the health state
 -- of your back-end instances.
 --
--- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/TerminologyandKeyConcepts.html#healthcheck Health Check> in the /Elastic Load BalancingDeveloper Guide/.
+-- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/TerminologyandKeyConcepts.html#healthcheck Health Checks> in the /Elastic Load BalancingDeveloper Guide/.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_ConfigureHealthCheck.html>
 module Network.AWS.ELB.ConfigureHealthCheck
@@ -72,13 +72,11 @@
     , _chcHealthCheck      = p2
     }
 
--- | A structure containing the configuration information for the new
--- healthcheck.
+-- | The configuration information for the new health check.
 chcHealthCheck :: Lens' ConfigureHealthCheck HealthCheck
 chcHealthCheck = lens _chcHealthCheck (\s a -> s { _chcHealthCheck = a })
 
--- | The mnemonic name associated with the load balancer. The name must be unique
--- within the set of load balancers associated with your AWS account.
+-- | The name of the load balancer.
 chcLoadBalancerName :: Lens' ConfigureHealthCheck Text
 chcLoadBalancerName =
     lens _chcLoadBalancerName (\s a -> s { _chcLoadBalancerName = a })
@@ -98,7 +96,7 @@
     { _chcrHealthCheck = Nothing
     }
 
--- | The updated healthcheck for the instances.
+-- | The updated health check.
 chcrHealthCheck :: Lens' ConfigureHealthCheckResponse (Maybe HealthCheck)
 chcrHealthCheck = lens _chcrHealthCheck (\s a -> s { _chcrHealthCheck = a })
 
diff --git a/gen/Network/AWS/ELB/CreateAppCookieStickinessPolicy.hs b/gen/Network/AWS/ELB/CreateAppCookieStickinessPolicy.hs
--- a/gen/Network/AWS/ELB/CreateAppCookieStickinessPolicy.hs
+++ b/gen/Network/AWS/ELB/CreateAppCookieStickinessPolicy.hs
@@ -26,19 +26,14 @@
 -- of an application-generated cookie. This policy can be associated only with
 -- HTTP/HTTPS listeners.
 --
--- This policy is similar to the policy created by 'CreateLBCookieStickinessPolicy', except that the lifetime of the special Elastic Load Balancing cookie
--- follows the lifetime of the application-generated cookie specified in the
+-- This policy is similar to the policy created by 'CreateLBCookieStickinessPolicy', except that the lifetime of the special Elastic Load Balancing cookie, 'AWSELB', follows the lifetime of the application-generated cookie specified in the
 -- policy configuration. The load balancer only inserts a new stickiness cookie
 -- when the application response includes a new application cookie.
 --
 -- If the application cookie is explicitly removed or expires, the session
 -- stops being sticky until a new application cookie is issued.
 --
--- An application client must receive and send two cookies: the
--- application-generated cookie and the special Elastic Load Balancing cookie
--- named 'AWSELB'. This is the default behavior for many common web browsers.  For
--- more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/US_StickySessions.html#US_EnableStickySessionsAppCookies Enabling Application-Controlled Session Stickiness> in
--- the /Elastic Load Balancing Developer Guide/.
+-- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/US_StickySessions.html#US_EnableStickySessionsAppCookies Application-Controlled Session Stickiness> in the /Elastic Load Balancing Developer Guide/.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_CreateAppCookieStickinessPolicy.html>
 module Network.AWS.ELB.CreateAppCookieStickinessPolicy
@@ -89,7 +84,7 @@
     , _cacspCookieName       = p3
     }
 
--- | Name of the application cookie used for stickiness.
+-- | The name of the application cookie used for stickiness.
 cacspCookieName :: Lens' CreateAppCookieStickinessPolicy Text
 cacspCookieName = lens _cacspCookieName (\s a -> s { _cacspCookieName = a })
 
@@ -98,7 +93,7 @@
 cacspLoadBalancerName =
     lens _cacspLoadBalancerName (\s a -> s { _cacspLoadBalancerName = a })
 
--- | The name of the policy being created. The name must be unique within the set
+-- | The name of the policy being created. This name must be unique within the set
 -- of policies for this load balancer.
 cacspPolicyName :: Lens' CreateAppCookieStickinessPolicy Text
 cacspPolicyName = lens _cacspPolicyName (\s a -> s { _cacspPolicyName = a })
diff --git a/gen/Network/AWS/ELB/CreateLBCookieStickinessPolicy.hs b/gen/Network/AWS/ELB/CreateLBCookieStickinessPolicy.hs
--- a/gen/Network/AWS/ELB/CreateLBCookieStickinessPolicy.hs
+++ b/gen/Network/AWS/ELB/CreateLBCookieStickinessPolicy.hs
@@ -22,23 +22,23 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Generates a stickiness policy with sticky session lifetimes controlled by
--- the lifetime of the browser (user-agent) or a specified expiration period.
--- This policy can be associated only with HTTP/HTTPS listeners.
+-- | Generates a stickiness policy with sticky session lifetimes controlled by the
+-- lifetime of the browser (user-agent) or a specified expiration period. This
+-- policy can be associated only with HTTP/HTTPS listeners.
 --
 -- When a load balancer implements this policy, the load balancer uses a
--- special cookie to track the backend server instance for each request. When
+-- special cookie to track the back-end server instance for each request. When
 -- the load balancer receives a request, it first checks to see if this cookie
 -- is present in the request. If so, the load balancer sends the request to the
 -- application server specified in the cookie. If not, the load balancer sends
--- the request to a server that is chosen based on the existing load balancing
+-- the request to a server that is chosen based on the existing load-balancing
 -- algorithm.
 --
 -- A cookie is inserted into the response for binding subsequent requests from
 -- the same user to that server. The validity of the cookie is based on the
 -- cookie expiration time, which is specified in the policy configuration.
 --
--- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/US_StickySessions.html#US_EnableStickySessionsLBCookies Enabling Duration-Based Session Stickiness> in the /Elastic Load Balancing Developer Guide/.
+-- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/US_StickySessions.html#US_EnableStickySessionsLBCookies Duration-Based Session Stickiness> in the /ElasticLoad Balancing Developer Guide/.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_CreateLBCookieStickinessPolicy.html>
 module Network.AWS.ELB.CreateLBCookieStickinessPolicy
@@ -88,20 +88,20 @@
     , _clbcspCookieExpirationPeriod = Nothing
     }
 
--- | The time period in seconds after which the cookie should be considered
--- stale. Not specifying this parameter indicates that the sticky session will
--- last for the duration of the browser session.
+-- | The time period, in seconds, after which the cookie should be considered
+-- stale. If you do not specify this parameter, the sticky session lasts for the
+-- duration of the browser session.
 clbcspCookieExpirationPeriod :: Lens' CreateLBCookieStickinessPolicy (Maybe Integer)
 clbcspCookieExpirationPeriod =
     lens _clbcspCookieExpirationPeriod
         (\s a -> s { _clbcspCookieExpirationPeriod = a })
 
--- | The name associated with the load balancer.
+-- | The name of the load balancer.
 clbcspLoadBalancerName :: Lens' CreateLBCookieStickinessPolicy Text
 clbcspLoadBalancerName =
     lens _clbcspLoadBalancerName (\s a -> s { _clbcspLoadBalancerName = a })
 
--- | The name of the policy being created. The name must be unique within the set
+-- | The name of the policy being created. This name must be unique within the set
 -- of policies for this load balancer.
 clbcspPolicyName :: Lens' CreateLBCookieStickinessPolicy Text
 clbcspPolicyName = lens _clbcspPolicyName (\s a -> s { _clbcspPolicyName = a })
diff --git a/gen/Network/AWS/ELB/CreateLoadBalancer.hs b/gen/Network/AWS/ELB/CreateLoadBalancer.hs
--- a/gen/Network/AWS/ELB/CreateLoadBalancer.hs
+++ b/gen/Network/AWS/ELB/CreateLoadBalancer.hs
@@ -22,29 +22,22 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Creates a new load balancer.
---
--- After the call has completed successfully, a new load balancer is created
--- with a unique Domain Name Service (DNS) name. The DNS name includes the name
--- of the AWS region in which the load balance was created. For example, if your
--- load balancer was created in the United States, the DNS name might end with
--- either of the following:
---
--- /us-east-1.elb.amazonaws.com/ (for the Northern Virginia region)   /us-west-1.elb.amazonaws.com/ (for the Northern California region)   For information about the AWS regions
--- supported by Elastic Load Balancing, see <http://docs.aws.amazon.com/general/latest/gr/rande.html#elb_region Regions and Endpoints>.
---
--- You can create up to 20 load balancers per region per account.
---
--- Elastic Load Balancing supports load balancing your Amazon EC2 instances
--- launched within any one of the following platforms:
+-- | Creates a load balancer.
 --
--- /EC2-Classic/ For information on creating and managing your load balancers
--- in EC2-Classic, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/UserScenariosForEC2.html Deploy Elastic Load Balancing in Amazon EC2-Classic>.
+-- If the call completes successfully, a new load balancer is created with a
+-- unique Domain Name Service (DNS) name. The DNS name includes the name of the
+-- AWS region in which the load balancer was created. For example, the DNS name
+-- might end with either of the following:
 --
--- /EC2-VPC/ For information on creating and managing your load balancers in
--- EC2-VPC, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/UserScenariosForVPC.html Deploy Elastic Load Balancing in Amazon VPC>.
+-- 'us-east-1.elb.amazonaws.com'   'us-west-2.elb.amazonaws.com'   For
+-- information about the AWS regions supported by Elastic Load Balancing, see <http://docs.aws.amazon.com/general/latest/gr/rande.html#elb_region Regions and Endpoints> in the /Amazon Web Services General Reference/.
 --
+-- You can create up to 20 load balancers per region per account. You can
+-- request an increase for the number of load balancers for your account. For
+-- more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/elb-limits.html Elastic Load Balancing Limits> in the /Elastic LoadBalancing Developer Guide/.
 --
+-- Elastic Load Balancing supports load balancing your EC2 instances launched
+-- in either the EC2-Classic or EC2-VPC platform. For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/UserScenariosForEC2.html Elastic Load Balancing in EC2-Classic> or <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/UserScenariosForVPC.html Elastic Load Balancing in a VPC> in the /Elastic Load Balancing DeveloperGuide/.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_CreateLoadBalancer.html>
 module Network.AWS.ELB.CreateLoadBalancer
@@ -116,60 +109,58 @@
     , _clbScheme            = Nothing
     }
 
--- | A list of Availability Zones.
+-- | One or more Availability Zones from the same region as the load balancer.
+-- Traffic is equally distributed across all specified Availability Zones.
 --
--- At least one Availability Zone must be specified. Specified Availability
--- Zones must be in the same EC2 Region as the load balancer. Traffic will be
--- equally distributed across all zones.
+-- You must specify at least one Availability Zone.
 --
--- You can later add more Availability Zones after the creation of the load
--- balancer by calling 'EnableAvailabilityZonesForLoadBalancer' action.
+-- You can add more Availability Zones after you create the load balancer using 'EnableAvailabilityZonesForLoadBalancer'.
 clbAvailabilityZones :: Lens' CreateLoadBalancer [Text]
 clbAvailabilityZones =
     lens _clbAvailabilityZones (\s a -> s { _clbAvailabilityZones = a })
         . _List
 
--- | A list of the following tuples: Protocol, LoadBalancerPort,
--- InstanceProtocol, InstancePort, and SSLCertificateId.
+-- | The listeners.
+--
+-- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/elb-listener-config.html Listener Configurations for Elastic Load Balancing>
+-- in the /Elastic Load Balancing Developer Guide/.
 clbListeners :: Lens' CreateLoadBalancer [Listener]
 clbListeners = lens _clbListeners (\s a -> s { _clbListeners = a }) . _List
 
--- | The name associated with the load balancer. The name must be unique within
--- your set of load balancers, must have a maximum of 32 characters, and must
--- only contain alphanumeric characters or hyphens.
+-- | The name of the load balancer.
+--
+-- This name must be unique within your AWS account, must have a maximum of 32
+-- characters, must contain only alphanumeric characters or hyphens, and cannot
+-- begin or end with a hyphen.
 clbLoadBalancerName :: Lens' CreateLoadBalancer Text
 clbLoadBalancerName =
     lens _clbLoadBalancerName (\s a -> s { _clbLoadBalancerName = a })
 
--- | The type of a load balancer.
+-- | The type of a load balancer. Valid only for load balancers in a VPC.
 --
 -- By default, Elastic Load Balancing creates an Internet-facing load balancer
 -- with a publicly resolvable DNS name, which resolves to public IP addresses.
--- For more information about Internet-facing and Internal load balancers, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/vpc-loadbalancer-types.html Internet-facing and Internal Load Balancers>.
---
--- Specify the value 'internal' for this option to create an internal load
--- balancer with a DNS name that resolves to private IP addresses.
---
--- This option is only available for load balancers created within EC2-VPC.
---
+-- For more information about Internet-facing and Internal load balancers, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/vpc-loadbalancer-types.html Internet-facing and Internal Load Balancers> in the /Elastic Load Balancing Developer Guide/.
 --
+-- Specify 'internal' to create an internal load balancer with a DNS name that
+-- resolves to private IP addresses.
 clbScheme :: Lens' CreateLoadBalancer (Maybe Text)
 clbScheme = lens _clbScheme (\s a -> s { _clbScheme = a })
 
--- | The security groups to assign to your load balancer within your VPC.
+-- | The IDs of the security groups to assign to the load balancer.
 clbSecurityGroups :: Lens' CreateLoadBalancer [Text]
 clbSecurityGroups =
     lens _clbSecurityGroups (\s a -> s { _clbSecurityGroups = a })
         . _List
 
--- | A list of subnet IDs in your VPC to attach to your load balancer. Specify
--- one subnet per Availability Zone.
+-- | The IDs of the subnets in your VPC to attach to the load balancer. Specify
+-- one subnet per Availability Zone specified in 'AvailabilityZones'.
 clbSubnets :: Lens' CreateLoadBalancer [Text]
 clbSubnets = lens _clbSubnets (\s a -> s { _clbSubnets = a }) . _List
 
 -- | A list of tags to assign to the load balancer.
 --
--- For more information about setting tags for your load balancer, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/TerminologyandKeyConcepts.html#tagging-elb Tagging>.
+-- For more information about tagging your load balancer, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/TerminologyandKeyConcepts.html#tagging-elb Tagging> in the /Elastic Load Balancing Developer Guide/.
 clbTags :: Lens' CreateLoadBalancer (NonEmpty Tag)
 clbTags = lens _clbTags (\s a -> s { _clbTags = a }) . _List1
 
@@ -188,7 +179,7 @@
     { _clbrDNSName = Nothing
     }
 
--- | The DNS name for the load balancer.
+-- | The DNS name of the load balancer.
 clbrDNSName :: Lens' CreateLoadBalancerResponse (Maybe Text)
 clbrDNSName = lens _clbrDNSName (\s a -> s { _clbrDNSName = a })
 
diff --git a/gen/Network/AWS/ELB/CreateLoadBalancerListeners.hs b/gen/Network/AWS/ELB/CreateLoadBalancerListeners.hs
--- a/gen/Network/AWS/ELB/CreateLoadBalancerListeners.hs
+++ b/gen/Network/AWS/ELB/CreateLoadBalancerListeners.hs
@@ -22,10 +22,10 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Creates one or more listeners on a load balancer for the specified port. If
--- a listener with the given port does not already exist, it will be created;
--- otherwise, the properties of the new listener must match the properties of
--- the existing listener.
+-- | Creates one or more listeners for the specified load balancer. If a listener
+-- with the specified port does not already exist, it is created; otherwise, the
+-- properties of the new listener must match the properties of the existing
+-- listener.
 --
 -- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/us-add-listener.html Add a Listener to Your Load Balancer> in the /Elastic Load Balancing Developer Guide/.
 --
@@ -71,7 +71,7 @@
     , _clblListeners        = mempty
     }
 
--- | A list of 'LoadBalancerPort', 'InstancePort', 'Protocol', 'InstanceProtocol', and 'SSLCertificateId' items.
+-- | The listeners.
 clblListeners :: Lens' CreateLoadBalancerListeners [Listener]
 clblListeners = lens _clblListeners (\s a -> s { _clblListeners = a }) . _List
 
diff --git a/gen/Network/AWS/ELB/CreateLoadBalancerPolicy.hs b/gen/Network/AWS/ELB/CreateLoadBalancerPolicy.hs
--- a/gen/Network/AWS/ELB/CreateLoadBalancerPolicy.hs
+++ b/gen/Network/AWS/ELB/CreateLoadBalancerPolicy.hs
@@ -22,11 +22,13 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Creates a new policy that contains the necessary attributes depending on the
--- policy type. Policies are settings that are saved for your load balancer and
--- that can be applied to the front-end listener, or the back-end application
--- server, depending on your policy type.
+-- | Creates a policy with the specified attributes for the specified load
+-- balancer.
 --
+-- Policies are settings that are saved for your load balancer and that can be
+-- applied to the front-end listener or the back-end application server,
+-- depending on the policy type.
+--
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_CreateLoadBalancerPolicy.html>
 module Network.AWS.ELB.CreateLoadBalancerPolicy
     (
@@ -81,25 +83,23 @@
     , _clbpPolicyAttributes = mempty
     }
 
--- | The name associated with the LoadBalancer for which the policy is being
--- created.
+-- | The name of the load balancer.
 clbpLoadBalancerName :: Lens' CreateLoadBalancerPolicy Text
 clbpLoadBalancerName =
     lens _clbpLoadBalancerName (\s a -> s { _clbpLoadBalancerName = a })
 
--- | A list of attributes associated with the policy being created.
+-- | The attributes for the policy.
 clbpPolicyAttributes :: Lens' CreateLoadBalancerPolicy [PolicyAttribute]
 clbpPolicyAttributes =
     lens _clbpPolicyAttributes (\s a -> s { _clbpPolicyAttributes = a })
         . _List
 
--- | The name of the load balancer policy being created. The name must be unique
+-- | The name of the load balancer policy to be created. This name must be unique
 -- within the set of policies for this load balancer.
 clbpPolicyName :: Lens' CreateLoadBalancerPolicy Text
 clbpPolicyName = lens _clbpPolicyName (\s a -> s { _clbpPolicyName = a })
 
--- | The name of the base policy type being used to create this policy. To get
--- the list of policy types, use the 'DescribeLoadBalancerPolicyTypes' action.
+-- | The name of the base policy type. To get the list of policy types, use 'DescribeLoadBalancerPolicyTypes'.
 clbpPolicyTypeName :: Lens' CreateLoadBalancerPolicy Text
 clbpPolicyTypeName =
     lens _clbpPolicyTypeName (\s a -> s { _clbpPolicyTypeName = a })
diff --git a/gen/Network/AWS/ELB/DeleteLoadBalancer.hs b/gen/Network/AWS/ELB/DeleteLoadBalancer.hs
--- a/gen/Network/AWS/ELB/DeleteLoadBalancer.hs
+++ b/gen/Network/AWS/ELB/DeleteLoadBalancer.hs
@@ -24,17 +24,13 @@
 
 -- | Deletes the specified load balancer.
 --
--- If attempting to recreate the load balancer, you must reconfigure all the
--- settings. The DNS name associated with a deleted load balancer will no longer
--- be usable. Once deleted, the name and associated DNS record of the load
--- balancer no longer exist and traffic sent to any of its IP addresses will no
--- longer be delivered to back-end instances.
---
--- To successfully call this API, you must provide the same account
--- credentials as were used to create the load balancer.
+-- If you are attempting to recreate a load balancer, you must reconfigure all
+-- settings. The DNS name associated with a deleted load balancer are no longer
+-- usable. The name and associated DNS record of the deleted load balancer no
+-- longer exist and traffic sent to any of its IP addresses is no longer
+-- delivered to back-end instances.
 --
--- By design, if the load balancer does not exist or has already been deleted,
--- a call to 'DeleteLoadBalancer' action still succeeds.
+-- If the load balancer does not exist or has already been deleted, the call to 'DeleteLoadBalancer' still succeeds.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_DeleteLoadBalancer.html>
 module Network.AWS.ELB.DeleteLoadBalancer
@@ -73,7 +69,7 @@
     { _dlbLoadBalancerName = p1
     }
 
--- | The name associated with the load balancer.
+-- | The name of the load balancer.
 dlbLoadBalancerName :: Lens' DeleteLoadBalancer Text
 dlbLoadBalancerName =
     lens _dlbLoadBalancerName (\s a -> s { _dlbLoadBalancerName = a })
diff --git a/gen/Network/AWS/ELB/DeleteLoadBalancerListeners.hs b/gen/Network/AWS/ELB/DeleteLoadBalancerListeners.hs
--- a/gen/Network/AWS/ELB/DeleteLoadBalancerListeners.hs
+++ b/gen/Network/AWS/ELB/DeleteLoadBalancerListeners.hs
@@ -22,7 +22,7 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Deletes listeners from the load balancer for the specified port.
+-- | Deletes the specified listeners from the specified load balancer.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_DeleteLoadBalancerListeners.html>
 module Network.AWS.ELB.DeleteLoadBalancerListeners
@@ -66,12 +66,12 @@
     , _dlblLoadBalancerPorts = mempty
     }
 
--- | The mnemonic name associated with the load balancer.
+-- | The name of the load balancer.
 dlblLoadBalancerName :: Lens' DeleteLoadBalancerListeners Text
 dlblLoadBalancerName =
     lens _dlblLoadBalancerName (\s a -> s { _dlblLoadBalancerName = a })
 
--- | The client port number(s) of the load balancer listener(s) to be removed.
+-- | The client port numbers of the listeners.
 dlblLoadBalancerPorts :: Lens' DeleteLoadBalancerListeners [Int]
 dlblLoadBalancerPorts =
     lens _dlblLoadBalancerPorts (\s a -> s { _dlblLoadBalancerPorts = a })
diff --git a/gen/Network/AWS/ELB/DeleteLoadBalancerPolicy.hs b/gen/Network/AWS/ELB/DeleteLoadBalancerPolicy.hs
--- a/gen/Network/AWS/ELB/DeleteLoadBalancerPolicy.hs
+++ b/gen/Network/AWS/ELB/DeleteLoadBalancerPolicy.hs
@@ -22,8 +22,8 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Deletes a policy from the load balancer. The specified policy must not be
--- enabled for any listeners.
+-- | Deletes the specified policy from the specified load balancer. This policy
+-- must not be enabled for any listeners.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_DeleteLoadBalancerPolicy.html>
 module Network.AWS.ELB.DeleteLoadBalancerPolicy
@@ -68,12 +68,12 @@
     , _dlbp1PolicyName       = p2
     }
 
--- | The mnemonic name associated with the load balancer.
+-- | The name of the load balancer.
 dlbp1LoadBalancerName :: Lens' DeleteLoadBalancerPolicy Text
 dlbp1LoadBalancerName =
     lens _dlbp1LoadBalancerName (\s a -> s { _dlbp1LoadBalancerName = a })
 
--- | The mnemonic name for the policy being deleted.
+-- | The name of the policy.
 dlbp1PolicyName :: Lens' DeleteLoadBalancerPolicy Text
 dlbp1PolicyName = lens _dlbp1PolicyName (\s a -> s { _dlbp1PolicyName = a })
 
diff --git a/gen/Network/AWS/ELB/DeregisterInstancesFromLoadBalancer.hs b/gen/Network/AWS/ELB/DeregisterInstancesFromLoadBalancer.hs
--- a/gen/Network/AWS/ELB/DeregisterInstancesFromLoadBalancer.hs
+++ b/gen/Network/AWS/ELB/DeregisterInstancesFromLoadBalancer.hs
@@ -22,18 +22,16 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Deregisters instances from the load balancer. Once the instance is
--- deregistered, it will stop receiving traffic from the load balancer.
+-- | Deregisters the specified instances from the specified load balancer. After
+-- the instance is deregistered, it no longer receives traffic from the load
+-- balancer.
 --
--- In order to successfully call this API, the same account credentials as
--- those used to create the load balancer must be provided.
+-- You can use 'DescribeLoadBalancers' to verify that the instance is
+-- deregistered from the load balancer.
 --
--- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/US_DeReg_Reg_Instances.html De-register and Register Amazon EC2 Instances> in
+-- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/US_DeReg_Reg_Instances.html Deregister and Register Amazon EC2 Instances> in
 -- the /Elastic Load Balancing Developer Guide/.
 --
--- You can use 'DescribeLoadBalancers' to verify if the instance is deregistered
--- from the load balancer.
---
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_DeregisterInstancesFromLoadBalancer.html>
 module Network.AWS.ELB.DeregisterInstancesFromLoadBalancer
     (
@@ -78,11 +76,11 @@
     , _diflbInstances        = mempty
     }
 
--- | A list of EC2 instance IDs consisting of all instances to be deregistered.
+-- | The IDs of the instances.
 diflbInstances :: Lens' DeregisterInstancesFromLoadBalancer [Instance]
 diflbInstances = lens _diflbInstances (\s a -> s { _diflbInstances = a }) . _List
 
--- | The name associated with the load balancer.
+-- | The name of the load balancer.
 diflbLoadBalancerName :: Lens' DeregisterInstancesFromLoadBalancer Text
 diflbLoadBalancerName =
     lens _diflbLoadBalancerName (\s a -> s { _diflbLoadBalancerName = a })
@@ -108,7 +106,7 @@
     { _diflbrInstances = mempty
     }
 
--- | An updated list of remaining instances registered with the load balancer.
+-- | The remaining instances registered with the load balancer.
 diflbrInstances :: Lens' DeregisterInstancesFromLoadBalancerResponse [Instance]
 diflbrInstances = lens _diflbrInstances (\s a -> s { _diflbrInstances = a }) . _List
 
diff --git a/gen/Network/AWS/ELB/DescribeInstanceHealth.hs b/gen/Network/AWS/ELB/DescribeInstanceHealth.hs
--- a/gen/Network/AWS/ELB/DescribeInstanceHealth.hs
+++ b/gen/Network/AWS/ELB/DescribeInstanceHealth.hs
@@ -22,12 +22,10 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Returns the current state of the specified instances registered with the
--- specified load balancer. If no instances are specified, the state of all the
--- instances registered with the load balancer is returned.
---
--- You must provide the same account credentials as those that were used to
--- create the load balancer.
+-- | Describes the state of the specified instances registered with the specified
+-- load balancer. If no instances are specified, the call describes the state of
+-- all instances registered with the load balancer, not including any terminated
+-- instances.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_DescribeInstanceHealth.html>
 module Network.AWS.ELB.DescribeInstanceHealth
@@ -73,7 +71,7 @@
     , _dihInstances        = mempty
     }
 
--- | A list of instance IDs whose states are being queried.
+-- | The IDs of the instances.
 dihInstances :: Lens' DescribeInstanceHealth [Instance]
 dihInstances = lens _dihInstances (\s a -> s { _dihInstances = a }) . _List
 
@@ -103,7 +101,7 @@
     { _dihrInstanceStates = mempty
     }
 
--- | A list containing health information for the specified instances.
+-- | Information about the health of the instances.
 dihrInstanceStates :: Lens' DescribeInstanceHealthResponse [InstanceState]
 dihrInstanceStates =
     lens _dihrInstanceStates (\s a -> s { _dihrInstanceStates = a })
diff --git a/gen/Network/AWS/ELB/DescribeLoadBalancerAttributes.hs b/gen/Network/AWS/ELB/DescribeLoadBalancerAttributes.hs
--- a/gen/Network/AWS/ELB/DescribeLoadBalancerAttributes.hs
+++ b/gen/Network/AWS/ELB/DescribeLoadBalancerAttributes.hs
@@ -22,8 +22,7 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Returns detailed information about all of the attributes associated with the
--- specified load balancer.
+-- | Describes the attributes for the specified load balancer.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_DescribeLoadBalancerAttributes.html>
 module Network.AWS.ELB.DescribeLoadBalancerAttributes
@@ -84,7 +83,7 @@
     { _dlbarLoadBalancerAttributes = Nothing
     }
 
--- | The load balancer attributes structure.
+-- | Information about the load balancer attributes.
 dlbarLoadBalancerAttributes :: Lens' DescribeLoadBalancerAttributesResponse (Maybe LoadBalancerAttributes)
 dlbarLoadBalancerAttributes =
     lens _dlbarLoadBalancerAttributes
diff --git a/gen/Network/AWS/ELB/DescribeLoadBalancerPolicies.hs b/gen/Network/AWS/ELB/DescribeLoadBalancerPolicies.hs
--- a/gen/Network/AWS/ELB/DescribeLoadBalancerPolicies.hs
+++ b/gen/Network/AWS/ELB/DescribeLoadBalancerPolicies.hs
@@ -22,14 +22,15 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Returns detailed descriptions of the policies. If you specify a load balancer
--- name, the action returns the descriptions of all the policies created for the
--- load balancer. If you specify a policy name associated with your load
--- balancer, the action returns the description of that policy. If you don't
--- specify a load balancer name, the action returns descriptions of the
--- specified sample policies, or descriptions of all the sample policies. The
--- names of the sample policies have the 'ELBSample-' prefix.
+-- | Describes the specified policies.
 --
+-- If you specify a load balancer name, the action returns the descriptions of
+-- all policies created for the load balancer. If you specify a policy name
+-- associated with your load balancer, the action returns the description of
+-- that policy. If you don't specify a load balancer name, the action returns
+-- descriptions of the specified sample policies, or descriptions of all sample
+-- policies. The names of the sample policies have the 'ELBSample-' prefix.
+--
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_DescribeLoadBalancerPolicies.html>
 module Network.AWS.ELB.DescribeLoadBalancerPolicies
     (
@@ -73,16 +74,12 @@
     , _dlbpPolicyNames      = mempty
     }
 
--- | The mnemonic name associated with the load balancer. If no name is
--- specified, the operation returns the attributes of either all the sample
--- policies pre-defined by Elastic Load Balancing or the specified sample
--- polices.
+-- | The name of the load balancer.
 dlbpLoadBalancerName :: Lens' DescribeLoadBalancerPolicies (Maybe Text)
 dlbpLoadBalancerName =
     lens _dlbpLoadBalancerName (\s a -> s { _dlbpLoadBalancerName = a })
 
--- | The names of load balancer policies you've created or Elastic Load Balancing
--- sample policy names.
+-- | The names of the policies.
 dlbpPolicyNames :: Lens' DescribeLoadBalancerPolicies [Text]
 dlbpPolicyNames = lens _dlbpPolicyNames (\s a -> s { _dlbpPolicyNames = a }) . _List
 
@@ -107,7 +104,7 @@
     { _dlbprPolicyDescriptions = mempty
     }
 
--- | A list of policy description structures.
+-- | Information about the policies.
 dlbprPolicyDescriptions :: Lens' DescribeLoadBalancerPoliciesResponse [PolicyDescription]
 dlbprPolicyDescriptions =
     lens _dlbprPolicyDescriptions (\s a -> s { _dlbprPolicyDescriptions = a })
diff --git a/gen/Network/AWS/ELB/DescribeLoadBalancerPolicyTypes.hs b/gen/Network/AWS/ELB/DescribeLoadBalancerPolicyTypes.hs
--- a/gen/Network/AWS/ELB/DescribeLoadBalancerPolicyTypes.hs
+++ b/gen/Network/AWS/ELB/DescribeLoadBalancerPolicyTypes.hs
@@ -22,11 +22,11 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Returns meta-information on the specified load balancer policies defined by
--- the Elastic Load Balancing service. The policy types that are returned from
--- this action can be used in a 'CreateLoadBalancerPolicy' action to instantiate
--- specific policy configurations that will be applied to a load balancer.
+-- | Describes the specified load balancer policy types.
 --
+-- You can use these policy types with 'CreateLoadBalancerPolicy' to create
+-- policy configurations for a load balancer.
+--
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_DescribeLoadBalancerPolicyTypes.html>
 module Network.AWS.ELB.DescribeLoadBalancerPolicyTypes
     (
@@ -71,9 +71,8 @@
     { _dlbptPolicyTypeNames = mempty
     }
 
--- | Specifies the name of the policy types. If no names are specified, returns
--- the description of all the policy types defined by Elastic Load Balancing
--- service.
+-- | The names of the policy types. If no names are specified, describes all
+-- policy types defined by Elastic Load Balancing.
 dlbptPolicyTypeNames :: Lens' DescribeLoadBalancerPolicyTypes [Text]
 dlbptPolicyTypeNames =
     lens _dlbptPolicyTypeNames (\s a -> s { _dlbptPolicyTypeNames = a })
@@ -100,9 +99,7 @@
     { _dlbptrPolicyTypeDescriptions = mempty
     }
 
--- | List of policy type description structures of the specified policy type. If
--- no policy type names are specified, returns the description of all the policy
--- types defined by Elastic Load Balancing service.
+-- | Information about the policy types.
 dlbptrPolicyTypeDescriptions :: Lens' DescribeLoadBalancerPolicyTypesResponse [PolicyTypeDescription]
 dlbptrPolicyTypeDescriptions =
     lens _dlbptrPolicyTypeDescriptions
diff --git a/gen/Network/AWS/ELB/DescribeLoadBalancers.hs b/gen/Network/AWS/ELB/DescribeLoadBalancers.hs
--- a/gen/Network/AWS/ELB/DescribeLoadBalancers.hs
+++ b/gen/Network/AWS/ELB/DescribeLoadBalancers.hs
@@ -22,12 +22,8 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Returns detailed configuration information for all the load balancers
--- created for the account. If you specify load balancer names, the action
--- returns configuration information of the specified load balancers.
---
--- In order to retrieve this information, you must provide the same account
--- credentials that was used to create the load balancer.
+-- | Describes the specified the load balancers. If no load balancers are
+-- specified, the call describes all of your load balancers.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_DescribeLoadBalancers.html>
 module Network.AWS.ELB.DescribeLoadBalancers
@@ -78,19 +74,19 @@
     , _dlbPageSize          = Nothing
     }
 
--- | A list of load balancer names associated with the account.
+-- | The names of the load balancers.
 dlbLoadBalancerNames :: Lens' DescribeLoadBalancers [Text]
 dlbLoadBalancerNames =
     lens _dlbLoadBalancerNames (\s a -> s { _dlbLoadBalancerNames = a })
         . _List
 
--- | An optional parameter used for pagination of results from this call. If
--- specified, the response includes only records beyond the marker.
+-- | The marker for the next set of results. (You received this marker from a
+-- previous call.)
 dlbMarker :: Lens' DescribeLoadBalancers (Maybe Text)
 dlbMarker = lens _dlbMarker (\s a -> s { _dlbMarker = a })
 
--- | The number of results returned in each page. The default is 400. You cannot
--- specify a page size greater than 400 or less than 1.
+-- | The maximum number of results to return with this call (a number from 1 to
+-- 400). The default is 400.
 dlbPageSize :: Lens' DescribeLoadBalancers (Maybe Natural)
 dlbPageSize = lens _dlbPageSize (\s a -> s { _dlbPageSize = a }) . mapping _Nat
 
@@ -113,15 +109,15 @@
     , _dlbrNextMarker               = Nothing
     }
 
--- | A list of load balancer description structures.
+-- | Information about the load balancers.
 dlbrLoadBalancerDescriptions :: Lens' DescribeLoadBalancersResponse [LoadBalancerDescription]
 dlbrLoadBalancerDescriptions =
     lens _dlbrLoadBalancerDescriptions
         (\s a -> s { _dlbrLoadBalancerDescriptions = a })
             . _List
 
--- | Specifies the value of next marker if the request returned more than one
--- page of results.
+-- | The marker to use when requesting the next set of results. If there are no
+-- additional results, the string is empty.
 dlbrNextMarker :: Lens' DescribeLoadBalancersResponse (Maybe Text)
 dlbrNextMarker = lens _dlbrNextMarker (\s a -> s { _dlbrNextMarker = a })
 
diff --git a/gen/Network/AWS/ELB/DescribeTags.hs b/gen/Network/AWS/ELB/DescribeTags.hs
--- a/gen/Network/AWS/ELB/DescribeTags.hs
+++ b/gen/Network/AWS/ELB/DescribeTags.hs
@@ -22,7 +22,7 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Describes the tags associated with one or more load balancers.
+-- | Describes the tags associated with the specified load balancers.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_DescribeTags.html>
 module Network.AWS.ELB.DescribeTags
@@ -90,7 +90,7 @@
     { _dtrTagDescriptions = mempty
     }
 
--- | A list of tag description structures.
+-- | Information about the tags.
 dtrTagDescriptions :: Lens' DescribeTagsResponse [TagDescription]
 dtrTagDescriptions =
     lens _dtrTagDescriptions (\s a -> s { _dtrTagDescriptions = a })
diff --git a/gen/Network/AWS/ELB/DetachLoadBalancerFromSubnets.hs b/gen/Network/AWS/ELB/DetachLoadBalancerFromSubnets.hs
--- a/gen/Network/AWS/ELB/DetachLoadBalancerFromSubnets.hs
+++ b/gen/Network/AWS/ELB/DetachLoadBalancerFromSubnets.hs
@@ -22,13 +22,12 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Removes subnets from the set of configured subnets in the Amazon Virtual
--- Private Cloud (Amazon VPC) for the load balancer.
+-- | Removes the specified subnets from the set of configured subnets for the load
+-- balancer.
 --
--- After a subnet is removed all of the EC2 instances registered with the load
--- balancer that are in the removed subnet will go into the /OutOfService/ state.
--- When a subnet is removed, the load balancer will balance the traffic among
--- the remaining routable subnets for the load balancer.
+-- After a subnet is removed, all EC2 instances registered with the load
+-- balancer in the removed subnet go into the 'OutOfService' state. Then, the load
+-- balancer balances the traffic among the remaining routable subnets.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_DetachLoadBalancerFromSubnets.html>
 module Network.AWS.ELB.DetachLoadBalancerFromSubnets
@@ -74,13 +73,12 @@
     , _dlbfsSubnets          = mempty
     }
 
--- | The name associated with the load balancer to be detached.
+-- | The name of the load balancer.
 dlbfsLoadBalancerName :: Lens' DetachLoadBalancerFromSubnets Text
 dlbfsLoadBalancerName =
     lens _dlbfsLoadBalancerName (\s a -> s { _dlbfsLoadBalancerName = a })
 
--- | A list of subnet IDs to remove from the set of configured subnets for the
--- load balancer.
+-- | The IDs of the subnets.
 dlbfsSubnets :: Lens' DetachLoadBalancerFromSubnets [Text]
 dlbfsSubnets = lens _dlbfsSubnets (\s a -> s { _dlbfsSubnets = a }) . _List
 
@@ -105,7 +103,7 @@
     { _dlbfsrSubnets = mempty
     }
 
--- | A list of subnet IDs the load balancer is now attached to.
+-- | The IDs of the remaining subnets for the load balancer.
 dlbfsrSubnets :: Lens' DetachLoadBalancerFromSubnetsResponse [Text]
 dlbfsrSubnets = lens _dlbfsrSubnets (\s a -> s { _dlbfsrSubnets = a }) . _List
 
diff --git a/gen/Network/AWS/ELB/DisableAvailabilityZonesForLoadBalancer.hs b/gen/Network/AWS/ELB/DisableAvailabilityZonesForLoadBalancer.hs
--- a/gen/Network/AWS/ELB/DisableAvailabilityZonesForLoadBalancer.hs
+++ b/gen/Network/AWS/ELB/DisableAvailabilityZonesForLoadBalancer.hs
@@ -22,16 +22,13 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Removes the specified EC2 Availability Zones from the set of configured
--- Availability Zones for the load balancer.
+-- | Removes the specified Availability Zones from the set of Availability Zones
+-- for the specified load balancer.
 --
--- There must be at least one Availability Zone registered with a load
--- balancer at all times. Once an Availability Zone is removed, all the
--- instances registered with the load balancer that are in the removed
--- Availability Zone go into the /OutOfService/ state. Upon Availability Zone
--- removal, the load balancer attempts to equally balance the traffic among its
--- remaining usable Availability Zones. Trying to remove an Availability Zone
--- that was not associated with the load balancer does nothing.
+-- There must be at least one Availability Zone registered with a load balancer
+-- at all times. After an Availability Zone is removed, all instances registered
+-- with the load balancer that are in the removed Availability Zone go into the 'OutOfService' state. Then, the load balancer attempts to equally balance the traffic among
+-- its remaining Availability Zones.
 --
 -- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/US_ShrinkLBApp04.html Disable an Availability Zone from a Load-BalancedApplication> in the /Elastic Load Balancing Developer Guide/.
 --
@@ -79,17 +76,13 @@
     , _dazflbAvailabilityZones = mempty
     }
 
--- | A list of Availability Zones to be removed from the load balancer.
---
--- There must be at least one Availability Zone registered with a load
--- balancer at all times. Specified Availability Zones must be in the same
--- region.
+-- | The Availability Zones.
 dazflbAvailabilityZones :: Lens' DisableAvailabilityZonesForLoadBalancer [Text]
 dazflbAvailabilityZones =
     lens _dazflbAvailabilityZones (\s a -> s { _dazflbAvailabilityZones = a })
         . _List
 
--- | The name associated with the load balancer.
+-- | The name of the load balancer.
 dazflbLoadBalancerName :: Lens' DisableAvailabilityZonesForLoadBalancer Text
 dazflbLoadBalancerName =
     lens _dazflbLoadBalancerName (\s a -> s { _dazflbLoadBalancerName = a })
@@ -115,7 +108,7 @@
     { _dazflbrAvailabilityZones = mempty
     }
 
--- | A list of updated Availability Zones for the load balancer.
+-- | The remaining Availability Zones for the load balancer.
 dazflbrAvailabilityZones :: Lens' DisableAvailabilityZonesForLoadBalancerResponse [Text]
 dazflbrAvailabilityZones =
     lens _dazflbrAvailabilityZones
diff --git a/gen/Network/AWS/ELB/EnableAvailabilityZonesForLoadBalancer.hs b/gen/Network/AWS/ELB/EnableAvailabilityZonesForLoadBalancer.hs
--- a/gen/Network/AWS/ELB/EnableAvailabilityZonesForLoadBalancer.hs
+++ b/gen/Network/AWS/ELB/EnableAvailabilityZonesForLoadBalancer.hs
@@ -22,14 +22,13 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Adds one or more EC2 Availability Zones to the load balancer.
+-- | Adds the specified Availability Zones to the set of Availability Zones for
+-- the specified load balancer.
 --
 -- The load balancer evenly distributes requests across all its registered
 -- Availability Zones that contain instances.
 --
--- The new EC2 Availability Zones to be added must be in the same EC2 Region
--- as the Availability Zones for which the load balancer was created.  For more
--- information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/US_AddLBAvailabilityZone.html Expand a Load Balanced Application to an AdditionalAvailability Zone> in the /Elastic Load Balancing Developer Guide/.
+-- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/US_AddLBAvailabilityZone.html Add Availability Zone> in the /Elastic LoadBalancing Developer Guide/.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_EnableAvailabilityZonesForLoadBalancer.html>
 module Network.AWS.ELB.EnableAvailabilityZonesForLoadBalancer
@@ -75,14 +74,13 @@
     , _eazflbAvailabilityZones = mempty
     }
 
--- | A list of new Availability Zones for the load balancer. Each Availability
--- Zone must be in the same region as the load balancer.
+-- | The Availability Zones. These must be in the same region as the load balancer.
 eazflbAvailabilityZones :: Lens' EnableAvailabilityZonesForLoadBalancer [Text]
 eazflbAvailabilityZones =
     lens _eazflbAvailabilityZones (\s a -> s { _eazflbAvailabilityZones = a })
         . _List
 
--- | The name associated with the load balancer.
+-- | The name of the load balancer.
 eazflbLoadBalancerName :: Lens' EnableAvailabilityZonesForLoadBalancer Text
 eazflbLoadBalancerName =
     lens _eazflbLoadBalancerName (\s a -> s { _eazflbLoadBalancerName = a })
@@ -108,7 +106,7 @@
     { _eazflbrAvailabilityZones = mempty
     }
 
--- | An updated list of Availability Zones for the load balancer.
+-- | The updated list of Availability Zones for the load balancer.
 eazflbrAvailabilityZones :: Lens' EnableAvailabilityZonesForLoadBalancerResponse [Text]
 eazflbrAvailabilityZones =
     lens _eazflbrAvailabilityZones
diff --git a/gen/Network/AWS/ELB/ModifyLoadBalancerAttributes.hs b/gen/Network/AWS/ELB/ModifyLoadBalancerAttributes.hs
--- a/gen/Network/AWS/ELB/ModifyLoadBalancerAttributes.hs
+++ b/gen/Network/AWS/ELB/ModifyLoadBalancerAttributes.hs
@@ -22,13 +22,13 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Modifies the attributes of a specified load balancer.
+-- | Modifies the attributes of the specified load balancer.
 --
 -- You can modify the load balancer attributes, such as 'AccessLogs', 'ConnectionDraining', and 'CrossZoneLoadBalancing' by either enabling or disabling them. Or, you
 -- can modify the load balancer attribute 'ConnectionSettings' by specifying an
 -- idle connection timeout value for your load balancer.
 --
--- For more information, see the following:
+-- For more information, see the following in the /Elastic Load BalancingDeveloper Guide/:
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/TerminologyandKeyConcepts.html#request-routing Cross-Zone Load Balancing> <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/TerminologyandKeyConcepts.html#conn-drain Connection Draining> <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/access-log-collection.html Access Logs> <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/TerminologyandKeyConcepts.html#idle-timeout Idle ConnectionTimeout>
 --
@@ -78,7 +78,7 @@
     , _mlbaLoadBalancerAttributes = p2
     }
 
--- | Attributes of the load balancer.
+-- | The attributes of the load balancer.
 mlbaLoadBalancerAttributes :: Lens' ModifyLoadBalancerAttributes LoadBalancerAttributes
 mlbaLoadBalancerAttributes =
     lens _mlbaLoadBalancerAttributes
diff --git a/gen/Network/AWS/ELB/RegisterInstancesWithLoadBalancer.hs b/gen/Network/AWS/ELB/RegisterInstancesWithLoadBalancer.hs
--- a/gen/Network/AWS/ELB/RegisterInstancesWithLoadBalancer.hs
+++ b/gen/Network/AWS/ELB/RegisterInstancesWithLoadBalancer.hs
@@ -22,32 +22,33 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Adds new instances to the load balancer.
+-- | Adds the specified instances to the specified load balancer.
 --
--- Once the instance is registered, it starts receiving traffic and requests
--- from the load balancer. Any instance that is not in any of the Availability
--- Zones registered for the load balancer will be moved to the /OutOfService/
--- state. It will move to the /InService/ state when the Availability Zone is
--- added to the load balancer.
+-- The instance must be a running instance in the same network as the load
+-- balancer (EC2-Classic or the same VPC). If you have EC2-Classic instances and
+-- a load balancer in a VPC with ClassicLink enabled, you can link the
+-- EC2-Classic instances to that VPC and then register the linked EC2-Classic
+-- instances with the load balancer in the VPC.
 --
--- When an instance registered with a load balancer is stopped and then
--- restarted, the IP addresses associated with the instance changes. Elastic
--- Load Balancing cannot recognize the new IP address, which prevents it from
--- routing traffic to the instances. We recommend that you de-register your
--- Amazon EC2 instances from your load balancer after you stop your instance,
--- and then register the load balancer with your instance after you've
--- restarted. To de-register your instances from load balancer, use 'DeregisterInstancesFromLoadBalancer' action.
+-- Note that 'RegisterInstanceWithLoadBalancer' completes when the request has
+-- been registered. Instance registration happens shortly afterwards. To check
+-- the state of the registered instances, use 'DescribeLoadBalancers' or 'DescribeInstanceHealth'.
 --
--- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/US_DeReg_Reg_Instances.html De-register and Register Amazon EC2 Instances> in
--- the /Elastic Load Balancing Developer Guide/.
+-- After the instance is registered, it starts receiving traffic and requests
+-- from the load balancer. Any instance that is not in one of the Availability
+-- Zones registered for the load balancer is moved to the 'OutOfService' state. If
+-- an Availability Zone is added to the load balancer later, any instances
+-- registered with the load balancer move to the 'InService' state.
 --
--- In order for this call to be successful, you must provide the same account
--- credentials as those that were used to create the load balancer.   Completion
--- of this API does not guarantee that operation has completed. Rather, it means
--- that the request has been registered and the changes will happen shortly.  You can use
--- 'DescribeLoadBalancers' or 'DescribeInstanceHealth' action to check the state of
--- the newly registered instances.
+-- If you stop an instance registered with a load balancer and then start it,
+-- the IP addresses associated with the instance changes. Elastic Load Balancing
+-- cannot recognize the new IP address, which prevents it from routing traffic
+-- to the instances. We recommend that you use the following sequence: stop the
+-- instance, deregister the instance, start the instance, and then register the
+-- instance. To deregister instances from a load balancer, use 'DeregisterInstancesFromLoadBalancer'.
 --
+-- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/US_DeReg_Reg_Instances.html Deregister and Register EC2 Instances> in the /Elastic Load Balancing Developer Guide/.
+--
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_RegisterInstancesWithLoadBalancer.html>
 module Network.AWS.ELB.RegisterInstancesWithLoadBalancer
     (
@@ -92,12 +93,11 @@
     , _riwlbInstances        = mempty
     }
 
--- | A list of instance IDs that should be registered with the load balancer.
+-- | The IDs of the instances.
 riwlbInstances :: Lens' RegisterInstancesWithLoadBalancer [Instance]
 riwlbInstances = lens _riwlbInstances (\s a -> s { _riwlbInstances = a }) . _List
 
--- | The name associated with the load balancer. The name must be unique within
--- your set of load balancers.
+-- | The name of the load balancer.
 riwlbLoadBalancerName :: Lens' RegisterInstancesWithLoadBalancer Text
 riwlbLoadBalancerName =
     lens _riwlbLoadBalancerName (\s a -> s { _riwlbLoadBalancerName = a })
@@ -123,7 +123,7 @@
     { _riwlbrInstances = mempty
     }
 
--- | An updated list of instances for the load balancer.
+-- | The updated list of instances for the load balancer.
 riwlbrInstances :: Lens' RegisterInstancesWithLoadBalancerResponse [Instance]
 riwlbrInstances = lens _riwlbrInstances (\s a -> s { _riwlbrInstances = a }) . _List
 
diff --git a/gen/Network/AWS/ELB/RemoveTags.hs b/gen/Network/AWS/ELB/RemoveTags.hs
--- a/gen/Network/AWS/ELB/RemoveTags.hs
+++ b/gen/Network/AWS/ELB/RemoveTags.hs
@@ -73,7 +73,7 @@
     lens _rtLoadBalancerNames (\s a -> s { _rtLoadBalancerNames = a })
         . _List
 
--- | A list of tag keys to remove.
+-- | The list of tag keys to remove.
 rtTags :: Lens' RemoveTags (NonEmpty TagKeyOnly)
 rtTags = lens _rtTags (\s a -> s { _rtTags = a }) . _List1
 
diff --git a/gen/Network/AWS/ELB/SetLoadBalancerListenerSSLCertificate.hs b/gen/Network/AWS/ELB/SetLoadBalancerListenerSSLCertificate.hs
--- a/gen/Network/AWS/ELB/SetLoadBalancerListenerSSLCertificate.hs
+++ b/gen/Network/AWS/ELB/SetLoadBalancerListenerSSLCertificate.hs
@@ -26,7 +26,7 @@
 -- connections. The specified certificate replaces any prior certificate that
 -- was used on the same load balancer and port.
 --
--- For more information on updating your SSL certificate, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/US_UpdatingLoadBalancerSSL.html Updating an SSLCertificate for a Load Balancer> in the /Elastic Load Balancing Developer Guide/.
+-- For more information about updating your SSL certificate, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/US_UpdatingLoadBalancerSSL.html Updating anSSL Certificate for a Load Balancer> in the /Elastic Load Balancing DeveloperGuide/.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_SetLoadBalancerListenerSSLCertificate.html>
 module Network.AWS.ELB.SetLoadBalancerListenerSSLCertificate
@@ -89,9 +89,7 @@
     lens _slblsslcLoadBalancerPort
         (\s a -> s { _slblsslcLoadBalancerPort = a })
 
--- | The Amazon Resource Number (ARN) of the SSL certificate chain to use. For
--- more information on SSL certificates, see <http://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingServerCerts.html  Managing Server Certificates> in
--- the /AWS Identity and Access Management User Guide/.
+-- | The Amazon Resource Name (ARN) of the SSL certificate.
 slblsslcSSLCertificateId :: Lens' SetLoadBalancerListenerSSLCertificate Text
 slblsslcSSLCertificateId =
     lens _slblsslcSSLCertificateId
diff --git a/gen/Network/AWS/ELB/SetLoadBalancerPoliciesForBackendServer.hs b/gen/Network/AWS/ELB/SetLoadBalancerPoliciesForBackendServer.hs
--- a/gen/Network/AWS/ELB/SetLoadBalancerPoliciesForBackendServer.hs
+++ b/gen/Network/AWS/ELB/SetLoadBalancerPoliciesForBackendServer.hs
@@ -22,20 +22,17 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Replaces the current set of policies associated with a port on which the
--- back-end server is listening with a new set of policies. After the policies
--- have been created using 'CreateLoadBalancerPolicy', they can be applied here as
--- a list. At this time, only the back-end server authentication policy type can
--- be applied to the back-end ports; this policy type is composed of multiple
--- public key policies.
+-- | Replaces the set of policies associated with the specified port on which the
+-- back-end server is listening with a new set of policies. At this time, only
+-- the back-end server authentication policy type can be applied to the back-end
+-- ports; this policy type is composed of multiple public key policies.
 --
--- The /SetLoadBalancerPoliciesForBackendServer/ replaces the current set of
--- policies associated with the specified instance port. Every time you use this
--- action to enable the policies, use the 'PolicyNames' parameter to list all the
--- policies you want to enable.
+-- Each time you use 'SetLoadBalancerPoliciesForBackendServer' to enable the
+-- policies, use the 'PolicyNames' parameter to list the policies that you want to
+-- enable.
 --
--- You can use 'DescribeLoadBalancers' or 'DescribeLoadBalancerPolicies' action to
--- verify that the policy has been associated with the back-end server.
+-- You can use 'DescribeLoadBalancers' or 'DescribeLoadBalancerPolicies' to verify
+-- that the policy is associated with the back-end server.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_SetLoadBalancerPoliciesForBackendServer.html>
 module Network.AWS.ELB.SetLoadBalancerPoliciesForBackendServer
@@ -90,14 +87,13 @@
 slbpfbsInstancePort =
     lens _slbpfbsInstancePort (\s a -> s { _slbpfbsInstancePort = a })
 
--- | The mnemonic name associated with the load balancer. This name must be
--- unique within the set of your load balancers.
+-- | The name of the load balancer.
 slbpfbsLoadBalancerName :: Lens' SetLoadBalancerPoliciesForBackendServer Text
 slbpfbsLoadBalancerName =
     lens _slbpfbsLoadBalancerName (\s a -> s { _slbpfbsLoadBalancerName = a })
 
--- | List of policy names to be set. If the list is empty, then all current
--- polices are removed from the back-end server.
+-- | The names of the policies. If the list is empty, then all current polices are
+-- removed from the back-end server.
 slbpfbsPolicyNames :: Lens' SetLoadBalancerPoliciesForBackendServer [Text]
 slbpfbsPolicyNames =
     lens _slbpfbsPolicyNames (\s a -> s { _slbpfbsPolicyNames = a })
diff --git a/gen/Network/AWS/ELB/SetLoadBalancerPoliciesOfListener.hs b/gen/Network/AWS/ELB/SetLoadBalancerPoliciesOfListener.hs
--- a/gen/Network/AWS/ELB/SetLoadBalancerPoliciesOfListener.hs
+++ b/gen/Network/AWS/ELB/SetLoadBalancerPoliciesOfListener.hs
@@ -22,8 +22,8 @@
 --
 -- Derived from AWS service descriptions, licensed under Apache 2.0.
 
--- | Associates, updates, or disables a policy with a listener on the load
--- balancer. You can associate multiple policies with a listener.
+-- | Associates, updates, or disables a policy with a listener for the specified
+-- load balancer. You can associate multiple policies with a listener.
 --
 -- <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_SetLoadBalancerPoliciesOfListener.html>
 module Network.AWS.ELB.SetLoadBalancerPoliciesOfListener
@@ -78,13 +78,13 @@
 slbpolLoadBalancerName =
     lens _slbpolLoadBalancerName (\s a -> s { _slbpolLoadBalancerName = a })
 
--- | The external port of the load balancer to associate the policy.
+-- | The external port of the load balancer for the policy.
 slbpolLoadBalancerPort :: Lens' SetLoadBalancerPoliciesOfListener Int
 slbpolLoadBalancerPort =
     lens _slbpolLoadBalancerPort (\s a -> s { _slbpolLoadBalancerPort = a })
 
--- | List of policies to be associated with the listener. If the list is empty,
--- the current policy is removed from the listener.
+-- | The names of the policies. If the list is empty, the current policy is
+-- removed from the listener.
 slbpolPolicyNames :: Lens' SetLoadBalancerPoliciesOfListener [Text]
 slbpolPolicyNames =
     lens _slbpolPolicyNames (\s a -> s { _slbpolPolicyNames = a })
diff --git a/gen/Network/AWS/ELB/Types.hs b/gen/Network/AWS/ELB/Types.hs
--- a/gen/Network/AWS/ELB/Types.hs
+++ b/gen/Network/AWS/ELB/Types.hs
@@ -252,7 +252,7 @@
               -> RESTError
               -> Bool
         check (statusCode -> s) (awsErrorCode -> e)
-            | s == 400 && "Throttling" == e = True -- Throttling
+            | s == 400 && (Just "Throttling") == e = True -- Throttling
             | s == 500  = True -- General Server Error
             | s == 509  = True -- Limit Exceeded
             | s == 503  = True -- Service Unavailable
@@ -281,12 +281,11 @@
     , _ssgGroupName  = Nothing
     }
 
--- | Name of the source security group. Use this value for the '--source-group'
--- parameter of the 'ec2-authorize' command in the Amazon EC2 command line tool.
+-- | The name of the security group.
 ssgGroupName :: Lens' SourceSecurityGroup (Maybe Text)
 ssgGroupName = lens _ssgGroupName (\s a -> s { _ssgGroupName = a })
 
--- | Owner of the source security group. Use this value for the '--source-group-user' parameter of the 'ec2-authorize' command in the Amazon EC2 command line tool.
+-- | The owner of the security group.
 ssgOwnerAlias :: Lens' SourceSecurityGroup (Maybe Text)
 ssgOwnerAlias = lens _ssgOwnerAlias (\s a -> s { _ssgOwnerAlias = a })
 
@@ -326,7 +325,7 @@
 tdLoadBalancerName =
     lens _tdLoadBalancerName (\s a -> s { _tdLoadBalancerName = a })
 
--- | List of tags associated with the load balancer.
+-- | The tags.
 tdTags :: Lens' TagDescription (NonEmpty Tag)
 tdTags = lens _tdTags (\s a -> s { _tdTags = a }) . _List1
 
@@ -411,19 +410,23 @@
     , _patdCardinality   = Nothing
     }
 
--- | The name of the attribute associated with the policy type.
+-- | The name of the attribute.
 patdAttributeName :: Lens' PolicyAttributeTypeDescription (Maybe Text)
 patdAttributeName =
     lens _patdAttributeName (\s a -> s { _patdAttributeName = a })
 
--- | The type of attribute. For example, Boolean, Integer, etc.
+-- | The type of the attribute. For example, 'Boolean' or 'Integer'.
 patdAttributeType :: Lens' PolicyAttributeTypeDescription (Maybe Text)
 patdAttributeType =
     lens _patdAttributeType (\s a -> s { _patdAttributeType = a })
 
--- | The cardinality of the attribute. Valid Values:  ONE(1) : Single value
--- required ZERO_OR_ONE(0..1) : Up to one value can be supplied ZERO_OR_MORE(0..*) : Optional. Multiple values are allowed
--- ONE_OR_MORE(1..*0) : Required. Multiple values are allowed
+-- | The cardinality of the attribute.
+--
+-- Valid values:
+--
+-- ONE(1) : Single value required ZERO_OR_ONE(0..1) : Up to one value can be
+-- supplied ZERO_OR_MORE(0..*) : Optional. Multiple values are allowed ONE_OR_MORE(1..*0) : Required. Multiple values are allowed
+--
 patdCardinality :: Lens' PolicyAttributeTypeDescription (Maybe Text)
 patdCardinality = lens _patdCardinality (\s a -> s { _patdCardinality = a })
 
@@ -431,7 +434,7 @@
 patdDefaultValue :: Lens' PolicyAttributeTypeDescription (Maybe Text)
 patdDefaultValue = lens _patdDefaultValue (\s a -> s { _patdDefaultValue = a })
 
--- | A human-readable description of the attribute.
+-- | A description of the attribute.
 patdDescription :: Lens' PolicyAttributeTypeDescription (Maybe Text)
 patdDescription = lens _patdDescription (\s a -> s { _patdDescription = a })
 
@@ -488,50 +491,48 @@
     , _hcHealthyThreshold   = withIso _Nat (const id) p5
     }
 
--- | Specifies the number of consecutive health probe successes required before
--- moving the instance to the /Healthy/ state.
+-- | The number of consecutive health checks successes required before moving the
+-- instance to the 'Healthy' state.
 hcHealthyThreshold :: Lens' HealthCheck Natural
 hcHealthyThreshold =
     lens _hcHealthyThreshold (\s a -> s { _hcHealthyThreshold = a })
         . _Nat
 
--- | Specifies the approximate interval, in seconds, between health checks of an
--- individual instance.
+-- | The approximate interval, in seconds, between health checks of an individual
+-- instance.
 hcInterval :: Lens' HealthCheck Natural
 hcInterval = lens _hcInterval (\s a -> s { _hcInterval = a }) . _Nat
 
--- | Specifies the instance being checked. The protocol is either TCP, HTTP,
--- HTTPS, or SSL. The range of valid ports is one (1) through 65535.
+-- | The instance being checked. The protocol is either TCP, HTTP, HTTPS, or SSL.
+-- The range of valid ports is one (1) through 65535.
 --
 -- TCP is the default, specified as a TCP: port pair, for example "TCP:5000".
--- In this case a healthcheck simply attempts to open a TCP connection to the
+-- In this case, a health check simply attempts to open a TCP connection to the
 -- instance on the specified port. Failure to connect within the configured
 -- timeout is considered unhealthy.
 --
 -- SSL is also specified as SSL: port pair, for example, SSL:5000.
 --
--- For HTTP or HTTPS protocol, the situation is different. You have to include
--- a ping path in the string. HTTP is specified as a HTTP:port;/;PathToPing;
--- grouping, for example "HTTP:80/weather/us/wa/seattle". In this case, a HTTP
--- GET request is issued to the instance on the given port and path. Any answer
--- other than "200 OK" within the timeout period is considered unhealthy.
+-- For HTTP/HTTPS, you must include a ping path in the string. HTTP is
+-- specified as a HTTP:port;/;PathToPing; grouping, for example
+-- "HTTP:80/weather/us/wa/seattle". In this case, a HTTP GET request is issued
+-- to the instance on the given port and path. Any answer other than "200 OK"
+-- within the timeout period is considered unhealthy.
 --
--- The total length of the HTTP ping target needs to be 1024 16-bit Unicode
+-- The total length of the HTTP ping target must be 1024 16-bit Unicode
 -- characters or less.
---
---
 hcTarget :: Lens' HealthCheck Text
 hcTarget = lens _hcTarget (\s a -> s { _hcTarget = a })
 
--- | Specifies the amount of time, in seconds, during which no response means a
--- failed health probe.
+-- | The amount of time, in seconds, during which no response means a failed
+-- health check.
 --
--- This value must be less than the /Interval/ value.
+-- This value must be less than the 'Interval' value.
 hcTimeout :: Lens' HealthCheck Natural
 hcTimeout = lens _hcTimeout (\s a -> s { _hcTimeout = a }) . _Nat
 
--- | Specifies the number of consecutive health probe failures required before
--- moving the instance to the /Unhealthy/ state.
+-- | The number of consecutive health check failures required before moving the
+-- instance to the 'Unhealthy' state.
 hcUnhealthyThreshold :: Lens' HealthCheck Natural
 hcUnhealthyThreshold =
     lens _hcUnhealthyThreshold (\s a -> s { _hcUnhealthyThreshold = a })
@@ -614,46 +615,42 @@
     , _lbaAdditionalAttributes   = mempty
     }
 
--- | The name of the load balancer attribute. If enabled, the load balancer
--- captures detailed information of all the requests and delivers the
--- information to the Amazon S3 bucket that you specify.
+-- | If enabled, the load balancer captures detailed information of all requests
+-- and delivers the information to the Amazon S3 bucket that you specify.
 --
--- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/enable-access-logs.html Enable Access Logs>.
+-- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/enable-access-logs.html Enable Access Logs> in the /Elastic Load BalancingDeveloper Guide/.
 lbaAccessLog :: Lens' LoadBalancerAttributes (Maybe AccessLog)
 lbaAccessLog = lens _lbaAccessLog (\s a -> s { _lbaAccessLog = a })
 
+-- | This parameter is reserved.
 lbaAdditionalAttributes :: Lens' LoadBalancerAttributes [AdditionalAttribute]
 lbaAdditionalAttributes =
     lens _lbaAdditionalAttributes (\s a -> s { _lbaAdditionalAttributes = a })
         . _List
 
--- | The name of the load balancer attribute. If enabled, the load balancer allows
--- existing requests to complete before the load balancer shifts traffic away
--- from a deregistered or unhealthy back-end instance.
+-- | If enabled, the load balancer allows existing requests to complete before the
+-- load balancer shifts traffic away from a deregistered or unhealthy back-end
+-- instance.
 --
--- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/config-conn-drain.html Enable Connection Draining>.
+-- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/config-conn-drain.html Enable Connection Draining> in the /Elastic LoadBalancing Developer Guide/.
 lbaConnectionDraining :: Lens' LoadBalancerAttributes (Maybe ConnectionDraining)
 lbaConnectionDraining =
     lens _lbaConnectionDraining (\s a -> s { _lbaConnectionDraining = a })
 
--- | The name of the load balancer attribute.
+-- | If enabled, the load balancer allows the connections to remain idle (no data
+-- is sent over the connection) for the specified duration.
 --
 -- By default, Elastic Load Balancing maintains a 60-second idle connection
--- timeout for both front-end and back-end connections of your load balancer. If
--- the 'ConnectionSettings' attribute is set, Elastic Load Balancing will allow
--- the connections to remain idle (no data is sent over the connection) for the
--- specified duration.
---
--- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/config-idle-timeout.html Configure Idle Connection Timeout>.
+-- timeout for both front-end and back-end connections of your load balancer.
+-- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/config-idle-timeout.html Configure Idle Connection Timeout> in the /ElasticLoad Balancing Developer Guide/.
 lbaConnectionSettings :: Lens' LoadBalancerAttributes (Maybe ConnectionSettings)
 lbaConnectionSettings =
     lens _lbaConnectionSettings (\s a -> s { _lbaConnectionSettings = a })
 
--- | The name of the load balancer attribute. If enabled, the load balancer routes
--- the request traffic evenly across all back-end instances regardless of the
--- Availability Zones.
+-- | If enabled, the load balancer routes the request traffic evenly across all
+-- back-end instances regardless of the Availability Zones.
 --
--- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/enable-disable-crosszone-lb.html Enable Cross-Zone Load Balancing>.
+-- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/enable-disable-crosszone-lb.html Enable Cross-Zone Load Balancing> in the /ElasticLoad Balancing Developer Guide/.
 lbaCrossZoneLoadBalancing :: Lens' LoadBalancerAttributes (Maybe CrossZoneLoadBalancing)
 lbaCrossZoneLoadBalancing =
     lens _lbaCrossZoneLoadBalancing
@@ -761,8 +758,7 @@
 ldListener :: Lens' ListenerDescription (Maybe Listener)
 ldListener = lens _ldListener (\s a -> s { _ldListener = a })
 
--- | A list of policies enabled for this listener. An empty list indicates that
--- no policies are enabled.
+-- | The policies. If there are no policies enabled, the list is empty.
 ldPolicyNames :: Lens' ListenerDescription [Text]
 ldPolicyNames = lens _ldPolicyNames (\s a -> s { _ldPolicyNames = a }) . _List
 
@@ -796,9 +792,9 @@
     , _lbcspCookieExpirationPeriod = Nothing
     }
 
--- | The time period in seconds after which the cookie should be considered stale.
--- Not specifying this parameter indicates that the stickiness session will last
--- for the duration of the browser session.
+-- | The time period, in seconds, after which the cookie should be considered
+-- stale. If this parameter is not specified, the stickiness session lasts for
+-- the duration of the browser session.
 lbcspCookieExpirationPeriod :: Lens' LBCookieStickinessPolicy (Maybe Integer)
 lbcspCookieExpirationPeriod =
     lens _lbcspCookieExpirationPeriod
@@ -843,18 +839,18 @@
     , _pdPolicyAttributeDescriptions = mempty
     }
 
--- | A list of policy attribute description structures.
+-- | The policy attributes.
 pdPolicyAttributeDescriptions :: Lens' PolicyDescription [PolicyAttributeDescription]
 pdPolicyAttributeDescriptions =
     lens _pdPolicyAttributeDescriptions
         (\s a -> s { _pdPolicyAttributeDescriptions = a })
             . _List
 
--- | The name of the policy associated with the load balancer.
+-- | The name of the policy.
 pdPolicyName :: Lens' PolicyDescription (Maybe Text)
 pdPolicyName = lens _pdPolicyName (\s a -> s { _pdPolicyName = a })
 
--- | The name of the policy type associated with the load balancer.
+-- | The name of the policy type.
 pdPolicyTypeName :: Lens' PolicyDescription (Maybe Text)
 pdPolicyTypeName = lens _pdPolicyTypeName (\s a -> s { _pdPolicyTypeName = a })
 
@@ -929,11 +925,11 @@
     , _paAttributeValue = Nothing
     }
 
--- | The name of the attribute associated with the policy.
+-- | The name of the attribute.
 paAttributeName :: Lens' PolicyAttribute (Maybe Text)
 paAttributeName = lens _paAttributeName (\s a -> s { _paAttributeName = a })
 
--- | The value of the attribute associated with the policy.
+-- | The value of the attribute.
 paAttributeValue :: Lens' PolicyAttribute (Maybe Text)
 paAttributeValue = lens _paAttributeValue (\s a -> s { _paAttributeValue = a })
 
@@ -1023,100 +1019,96 @@
     , _lbdScheme                    = Nothing
     }
 
--- | Specifies a list of Availability Zones.
+-- | The Availability Zones for the load balancer.
 lbdAvailabilityZones :: Lens' LoadBalancerDescription [Text]
 lbdAvailabilityZones =
     lens _lbdAvailabilityZones (\s a -> s { _lbdAvailabilityZones = a })
         . _List
 
--- | Contains a list of back-end server descriptions.
+-- | Information about the back-end servers.
 lbdBackendServerDescriptions :: Lens' LoadBalancerDescription [BackendServerDescription]
 lbdBackendServerDescriptions =
     lens _lbdBackendServerDescriptions
         (\s a -> s { _lbdBackendServerDescriptions = a })
             . _List
 
--- | Provides the name of the Amazon Route 53 hosted zone that is associated with
--- the load balancer. For information on how to associate your load balancer
--- with a hosted zone, go to <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/using-domain-names-with-elb.html Using Domain Names With Elastic Load Balancing> in
+-- | The Amazon Route 53 hosted zone associated with the load balancer.
+--
+-- For more information, see <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/using-domain-names-with-elb.html Using Domain Names With Elastic Load Balancing> in
 -- the /Elastic Load Balancing Developer Guide/.
 lbdCanonicalHostedZoneName :: Lens' LoadBalancerDescription (Maybe Text)
 lbdCanonicalHostedZoneName =
     lens _lbdCanonicalHostedZoneName
         (\s a -> s { _lbdCanonicalHostedZoneName = a })
 
--- | Provides the ID of the Amazon Route 53 hosted zone name that is associated
--- with the load balancer. For information on how to associate or disassociate
--- your load balancer with a hosted zone, go to <http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/using-domain-names-with-elb.html Using Domain Names With ElasticLoad Balancing> in the /Elastic Load Balancing Developer Guide/.
+-- | The ID of the Amazon Route 53 hosted zone name associated with the load
+-- balancer.
 lbdCanonicalHostedZoneNameID :: Lens' LoadBalancerDescription (Maybe Text)
 lbdCanonicalHostedZoneNameID =
     lens _lbdCanonicalHostedZoneNameID
         (\s a -> s { _lbdCanonicalHostedZoneNameID = a })
 
--- | Provides the date and time the load balancer was created.
+-- | The date and time the load balancer was created.
 lbdCreatedTime :: Lens' LoadBalancerDescription (Maybe UTCTime)
 lbdCreatedTime = lens _lbdCreatedTime (\s a -> s { _lbdCreatedTime = a }) . mapping _Time
 
--- | Specifies the external DNS name associated with the load balancer.
+-- | The external DNS name of the load balancer.
 lbdDNSName :: Lens' LoadBalancerDescription (Maybe Text)
 lbdDNSName = lens _lbdDNSName (\s a -> s { _lbdDNSName = a })
 
--- | Specifies information regarding the various health probes conducted on the
--- load balancer.
+-- | Information about the health checks conducted on the load balancer.
 lbdHealthCheck :: Lens' LoadBalancerDescription (Maybe HealthCheck)
 lbdHealthCheck = lens _lbdHealthCheck (\s a -> s { _lbdHealthCheck = a })
 
--- | Provides a list of EC2 instance IDs for the load balancer.
+-- | The IDs of the instances for the load balancer.
 lbdInstances :: Lens' LoadBalancerDescription [Instance]
 lbdInstances = lens _lbdInstances (\s a -> s { _lbdInstances = a }) . _List
 
--- | LoadBalancerPort, InstancePort, Protocol, InstanceProtocol, and PolicyNames
--- are returned in a list of tuples in the ListenerDescriptions element.
+-- | The listeners for the load balancer.
 lbdListenerDescriptions :: Lens' LoadBalancerDescription [ListenerDescription]
 lbdListenerDescriptions =
     lens _lbdListenerDescriptions (\s a -> s { _lbdListenerDescriptions = a })
         . _List
 
--- | Specifies the name associated with the load balancer.
+-- | The name of the load balancer.
 lbdLoadBalancerName :: Lens' LoadBalancerDescription (Maybe Text)
 lbdLoadBalancerName =
     lens _lbdLoadBalancerName (\s a -> s { _lbdLoadBalancerName = a })
 
--- | Provides a list of policies defined for the load balancer.
+-- | The policies defined for the load balancer.
 lbdPolicies :: Lens' LoadBalancerDescription (Maybe Policies)
 lbdPolicies = lens _lbdPolicies (\s a -> s { _lbdPolicies = a })
 
--- | Specifies the type of load balancer.
---
--- If the 'Scheme' is 'internet-facing', the load balancer has a publicly
--- resolvable DNS name that resolves to public IP addresses.
+-- | The type of load balancer. Valid only for load balancers in a VPC.
 --
--- If the 'Scheme' is 'internal', the load balancer has a publicly resolvable DNS
--- name that resolves to private IP addresses.
+-- If 'Scheme' is 'internet-facing', the load balancer has a public DNS name that
+-- resolves to a public IP address.
 --
--- This option is only available for load balancers attached to an Amazon VPC.
+-- If 'Scheme' is 'internal', the load balancer has a public DNS name that resolves
+-- to a private IP address.
 lbdScheme :: Lens' LoadBalancerDescription (Maybe Text)
 lbdScheme = lens _lbdScheme (\s a -> s { _lbdScheme = a })
 
--- | The security groups the load balancer is a member of (VPC only).
+-- | The security groups for the load balancer. Valid only for load balancers in a
+-- VPC.
 lbdSecurityGroups :: Lens' LoadBalancerDescription [Text]
 lbdSecurityGroups =
     lens _lbdSecurityGroups (\s a -> s { _lbdSecurityGroups = a })
         . _List
 
 -- | The security group that you can use as part of your inbound rules for your
--- load balancer's back-end Amazon EC2 application instances. To only allow
--- traffic from load balancers, add a security group rule to your back end
--- instance that specifies this source security group as the inbound source.
+-- load balancer's back-end application instances. To only allow traffic from
+-- load balancers, add a security group rule to your back end instance that
+-- specifies this source security group as the inbound source.
 lbdSourceSecurityGroup :: Lens' LoadBalancerDescription (Maybe SourceSecurityGroup)
 lbdSourceSecurityGroup =
     lens _lbdSourceSecurityGroup (\s a -> s { _lbdSourceSecurityGroup = a })
 
--- | Provides a list of VPC subnet IDs for the load balancer.
+-- | The IDs of the subnets for the load balancer.
 lbdSubnets :: Lens' LoadBalancerDescription [Text]
 lbdSubnets = lens _lbdSubnets (\s a -> s { _lbdSubnets = a }) . _List
 
--- | Provides the ID of the VPC attached to the load balancer.
+-- | The ID of the VPC for the load balancer.
 lbdVPCId :: Lens' LoadBalancerDescription (Maybe Text)
 lbdVPCId = lens _lbdVPCId (\s a -> s { _lbdVPCId = a })
 
@@ -1178,11 +1170,11 @@
     , _bsdPolicyNames  = mempty
     }
 
--- | Provides the port on which the back-end server is listening.
+-- | The port on which the back-end server is listening.
 bsdInstancePort :: Lens' BackendServerDescription (Maybe Natural)
 bsdInstancePort = lens _bsdInstancePort (\s a -> s { _bsdInstancePort = a }) . mapping _Nat
 
--- | Provides a list of policy names enabled for the back-end server.
+-- | The names of the policies enabled for the back-end server.
 bsdPolicyNames :: Lens' BackendServerDescription [Text]
 bsdPolicyNames = lens _bsdPolicyNames (\s a -> s { _bsdPolicyNames = a }) . _List
 
@@ -1216,11 +1208,11 @@
     , _padAttributeValue = Nothing
     }
 
--- | The name of the attribute associated with the policy.
+-- | The name of the attribute.
 padAttributeName :: Lens' PolicyAttributeDescription (Maybe Text)
 padAttributeName = lens _padAttributeName (\s a -> s { _padAttributeName = a })
 
--- | The value of the attribute associated with the policy.
+-- | The value of the attribute.
 padAttributeValue :: Lens' PolicyAttributeDescription (Maybe Text)
 padAttributeValue =
     lens _padAttributeValue (\s a -> s { _padAttributeValue = a })
@@ -1255,9 +1247,11 @@
     , _aaValue = Nothing
     }
 
+-- | This parameter is reserved.
 aaKey :: Lens' AdditionalAttribute (Maybe Text)
 aaKey = lens _aaKey (\s a -> s { _aaKey = a })
 
+-- | This parameter is reserved.
 aaValue :: Lens' AdditionalAttribute (Maybe Text)
 aaValue = lens _aaValue (\s a -> s { _aaValue = a })
 
@@ -1288,8 +1282,8 @@
     { _csIdleTimeout = withIso _Nat (const id) p1
     }
 
--- | Specifies the time (in seconds) the connection is allowed to be idle (no data
--- has been sent over the connection) before it is closed by the load balancer.
+-- | The time, in seconds, that the connection is allowed to be idle (no data has
+-- been sent over the connection) before it is closed by the load balancer.
 csIdleTimeout :: Lens' ConnectionSettings Natural
 csIdleTimeout = lens _csIdleTimeout (\s a -> s { _csIdleTimeout = a }) . _Nat
 
@@ -1325,12 +1319,12 @@
     , _ptdPolicyAttributeTypeDescriptions = mempty
     }
 
--- | A human-readable description of the policy type.
+-- | A description of the policy type.
 ptdDescription :: Lens' PolicyTypeDescription (Maybe Text)
 ptdDescription = lens _ptdDescription (\s a -> s { _ptdDescription = a })
 
--- | The description of the policy attributes associated with the load balancer
--- policies defined by the Elastic Load Balancing service.
+-- | The description of the policy attributes associated with the policies defined
+-- by Elastic Load Balancing.
 ptdPolicyAttributeTypeDescriptions :: Lens' PolicyTypeDescription [PolicyAttributeTypeDescription]
 ptdPolicyAttributeTypeDescriptions =
     lens _ptdPolicyAttributeTypeDescriptions
@@ -1378,21 +1372,21 @@
     , _pOtherPolicies               = mempty
     }
 
--- | A list of the 'AppCookieStickinessPolicy' objects created with 'CreateAppCookieStickinessPolicy'.
+-- | The stickiness policies created using 'CreateAppCookieStickinessPolicy'.
 pAppCookieStickinessPolicies :: Lens' Policies [AppCookieStickinessPolicy]
 pAppCookieStickinessPolicies =
     lens _pAppCookieStickinessPolicies
         (\s a -> s { _pAppCookieStickinessPolicies = a })
             . _List
 
--- | A list of 'LBCookieStickinessPolicy' objects created with 'CreateAppCookieStickinessPolicy'.
+-- | The stickiness policies created using 'CreateLBCookieStickinessPolicy'.
 pLBCookieStickinessPolicies :: Lens' Policies [LBCookieStickinessPolicy]
 pLBCookieStickinessPolicies =
     lens _pLBCookieStickinessPolicies
         (\s a -> s { _pLBCookieStickinessPolicies = a })
             . _List
 
--- | A list of policy names other than the stickiness policies.
+-- | The policies other than the stickiness policies.
 pOtherPolicies :: Lens' Policies [Text]
 pOtherPolicies = lens _pOtherPolicies (\s a -> s { _pOtherPolicies = a }) . _List
 
@@ -1443,39 +1437,37 @@
     , _lSSLCertificateId = Nothing
     }
 
--- | Specifies the TCP port on which the instance server is listening. This
--- property cannot be modified for the life of the load balancer.
+-- | The port on which the instance server is listening - 25, 80, 443, 465, 587,
+-- or 1024-65535.
 lInstancePort :: Lens' Listener Natural
 lInstancePort = lens _lInstancePort (\s a -> s { _lInstancePort = a }) . _Nat
 
--- | Specifies the protocol to use for routing traffic to back-end instances -
--- HTTP, HTTPS, TCP, or SSL. This property cannot be modified for the life of
--- the load balancer.
+-- | The protocol to use for routing traffic to back-end instances: HTTP, HTTPS,
+-- TCP, or SSL.
 --
--- If the front-end protocol is HTTP or HTTPS, 'InstanceProtocol' has to be at
--- the same protocol layer, i.e., HTTP or HTTPS. Likewise, if the front-end
--- protocol is TCP or SSL, InstanceProtocol has to be TCP or SSL.   If there is
--- another listener with the same 'InstancePort' whose 'InstanceProtocol' is secure,
--- i.e., HTTPS or SSL, the listener's 'InstanceProtocol' has to be secure, i.e.,
--- HTTPS or SSL. If there is another listener with the same 'InstancePort' whose 'InstanceProtocol' is HTTP or TCP, the listener's 'InstanceProtocol' must be either HTTP or TCP.
+-- If the front-end protocol is HTTP, HTTPS, TCP, or SSL, 'InstanceProtocol' must
+-- be at the same protocol.
+--
+-- If there is another listener with the same 'InstancePort' whose 'InstanceProtocol' is secure, (HTTPS or SSL), the listener's 'InstanceProtocol' must also be
+-- secure.
+--
+-- If there is another listener with the same 'InstancePort' whose 'InstanceProtocol' is HTTP or TCP, the listener's 'InstanceProtocol' must be HTTP or TCP.
 lInstanceProtocol :: Lens' Listener (Maybe Text)
 lInstanceProtocol =
     lens _lInstanceProtocol (\s a -> s { _lInstanceProtocol = a })
 
--- | Specifies the external load balancer port number. This property cannot be
--- modified for the life of the load balancer.
+-- | The port on which the load balancer is listening: 25, 80, 443, 465, 587, or
+-- 1024-65535.
 lLoadBalancerPort :: Lens' Listener Int
 lLoadBalancerPort =
     lens _lLoadBalancerPort (\s a -> s { _lLoadBalancerPort = a })
 
--- | Specifies the load balancer transport protocol to use for routing - HTTP,
--- HTTPS, TCP or SSL. This property cannot be modified for the life of the load
--- balancer.
+-- | The load balancer transport protocol to use for routing: HTTP, HTTPS, TCP, or
+-- SSL.
 lProtocol :: Lens' Listener Text
 lProtocol = lens _lProtocol (\s a -> s { _lProtocol = a })
 
--- | The ARN string of the server certificate. To get the ARN of the server
--- certificate, call the AWS Identity and Access Management <http://docs.aws.amazon.com/IAM/latest/APIReference/index.html?API_UploadServerCertificate.html UploadServerCertificate > API.
+-- | The Amazon Resource Name (ARN) of the server certificate.
 lSSLCertificateId :: Lens' Listener (Maybe Text)
 lSSLCertificateId =
     lens _lSSLCertificateId (\s a -> s { _lSSLCertificateId = a })
@@ -1521,8 +1513,8 @@
 cdEnabled :: Lens' ConnectionDraining Bool
 cdEnabled = lens _cdEnabled (\s a -> s { _cdEnabled = a })
 
--- | Specifies the maximum time (in seconds) to keep the existing connections open
--- before deregistering the instances.
+-- | The maximum time, in seconds, to keep the existing connections open before
+-- deregistering the instances.
 cdTimeout :: Lens' ConnectionDraining (Maybe Int)
 cdTimeout = lens _cdTimeout (\s a -> s { _cdTimeout = a })
 
@@ -1564,25 +1556,51 @@
     , _isDescription = Nothing
     }
 
--- | Provides a description of the instance state.
+-- | A description of the instance state. This string can contain one or more of
+-- the following messages.
+--
+-- 'N/A'
+--
+-- 'A transient error occurred. Please try again later.'
+--
+-- 'Instance has failed at least the UnhealthyThreshold number of healthchecks consecutively.'
+--
+-- 'Instance has not passed the configured HealthyThreshold number of healthchecks consecutively.'
+--
+-- 'Instance registration is still in progress.'
+--
+-- 'Instance is in the EC2 Availability Zone for which LoadBalancer is notconfigured to route traffic to.'
+--
+-- 'Instance is not currently registered with the LoadBalancer.'
+--
+-- 'Instance deregistration currently in progress.'
+--
+-- 'Disable Availability Zone is currently in progress.'
+--
+-- 'Instance is in pending state.'
+--
+-- 'Instance is in stopped state.'
+--
+-- 'Instance is in terminated state.'
+--
+--
 isDescription :: Lens' InstanceState (Maybe Text)
 isDescription = lens _isDescription (\s a -> s { _isDescription = a })
 
--- | Provides an EC2 instance ID.
+-- | The ID of the instance.
 isInstanceId :: Lens' InstanceState (Maybe Text)
 isInstanceId = lens _isInstanceId (\s a -> s { _isInstanceId = a })
 
--- | Provides information about the cause of /OutOfService/ instances.
--- Specifically, it indicates whether the cause is Elastic Load Balancing or the
--- instance behind the load balancer.
+-- | Information about the cause of 'OutOfService' instances. Specifically, whether
+-- the cause is Elastic Load Balancing or the instance.
 --
--- Valid value: 'ELB'|'Instance'|'N/A'
+-- Valid values: 'ELB' | 'Instance' | 'N/A'
 isReasonCode :: Lens' InstanceState (Maybe Text)
 isReasonCode = lens _isReasonCode (\s a -> s { _isReasonCode = a })
 
--- | Specifies the current state of the instance.
+-- | The current state of the instance.
 --
--- Valid value: 'InService'|'OutOfService'|'Unknown'
+-- Valid values: 'InService' | 'OutOfService' | 'Unknown'
 isState :: Lens' InstanceState (Maybe Text)
 isState = lens _isState (\s a -> s { _isState = a })
 
@@ -1644,7 +1662,7 @@
     { _iInstanceId = Nothing
     }
 
--- | Provides an EC2 instance ID.
+-- | The ID of the instance.
 iInstanceId :: Lens' Instance (Maybe Text)
 iInstanceId = lens _iInstanceId (\s a -> s { _iInstanceId = a })
 
