Merge pull request #42689 from hashicorp/d-further-arguments-byline-standardization

Documentation: Additional `Argument Reference` section byline standardization

Author: ewbankkit

website/docs/d/apigatewayv2_api.html.markdown

@@ -20,9 +20,6 @@ data "aws_apigatewayv2_api" "example" {
 
 ## Argument Reference
 
-The arguments of this data source act as filters for querying the available APIs in the current region.
-The given filters must match exactly one API whose data will be exported as attributes.
-
 This data source supports the following arguments:
 
 * `api_id` - (Required) API identifier.

website/docs/d/connect_contact_flow.html.markdown

@@ -32,14 +32,14 @@ data "aws_connect_contact_flow" "test" {
 
 ## Argument Reference
 
-~> **NOTE:** `instance_id` and one of either `name` or `contact_flow_id` is required.
-
 This data source supports the following arguments:
 
 * `contact_flow_id` - (Optional) Returns information on a specific Contact Flow by contact flow id
 * `instance_id` - (Required) Reference to the hosting Amazon Connect Instance
 * `name` - (Optional) Returns information on a specific Contact Flow by name
 
+~> **NOTE:** `instance_id` and one of either `name` or `contact_flow_id` is required.
+
 ## Attribute Reference
 
 This data source exports the following attributes in addition to the arguments above:

website/docs/d/connect_contact_flow_module.html.markdown

@@ -32,14 +32,14 @@ data "aws_connect_contact_flow_module" "example" {
 
 ## Argument Reference
 
-~> **NOTE:** `instance_id` and one of either `name` or `contact_flow_module_id` is required.
-
 This data source supports the following arguments:
 
 * `contact_flow_module_id` - (Optional) Returns information on a specific Contact Flow Module by contact flow module id
 * `instance_id` - (Required) Reference to the hosting Amazon Connect Instance
 * `name` - (Optional) Returns information on a specific Contact Flow Module by name
 
+~> **NOTE:** `instance_id` and one of either `name` or `contact_flow_module_id` is required.
+
 ## Attribute Reference
 
 This data source exports the following attributes in addition to the arguments above:

website/docs/d/connect_hours_of_operation.html.markdown

@@ -32,14 +32,14 @@ data "aws_connect_hours_of_operation" "test" {
 
 ## Argument Reference
 
-~> **NOTE:** `instance_id` and one of either `name` or `hours_of_operation_id` is required.
-
 This data source supports the following arguments:
 
 * `hours_of_operation_id` - (Optional) Returns information on a specific Hours of Operation by hours of operation id
 * `instance_id` - (Required) Reference to the hosting Amazon Connect Instance
 * `name` - (Optional) Returns information on a specific Hours of Operation by name
 
+~> **NOTE:** `instance_id` and one of either `name` or `hours_of_operation_id` is required.
+
 ## Attribute Reference
 
 This data source exports the following attributes in addition to the arguments above:

website/docs/d/connect_instance.html.markdown

@@ -30,14 +30,13 @@ data "aws_connect_instance" "foo" {
 
 ## Argument Reference
 
-~> **NOTE:** One of either `instance_id` or `instance_alias` is required.
-
 This data source supports the following arguments:
 
 * `instance_id` - (Optional) Returns information on a specific connect instance by id
-
 * `instance_alias` - (Optional) Returns information on a specific connect instance by alias
 
+~> **NOTE:** One of either `instance_id` or `instance_alias` is required.
+
 ## Attribute Reference
 
 This data source exports the following attributes in addition to the arguments above:

website/docs/d/connect_queue.html.markdown

@@ -32,14 +32,14 @@ data "aws_connect_queue" "example" {
 
 ## Argument Reference
 
-~> **NOTE:** `instance_id` and one of either `name` or `queue_id` is required.
-
 This data source supports the following arguments:
 
 * `queue_id` - (Optional) Returns information on a specific Queue by Queue id
 * `instance_id` - (Required) Reference to the hosting Amazon Connect Instance
 * `name` - (Optional) Returns information on a specific Queue by name
 
+~> **NOTE:** `instance_id` and one of either `name` or `queue_id` is required.
+
 ## Attribute Reference
 
 This data source exports the following attributes in addition to the arguments above:

website/docs/d/connect_quick_connect.html.markdown

@@ -32,14 +32,14 @@ data "aws_connect_quick_connect" "example" {
 
 ## Argument Reference
 
-~> **NOTE:** `instance_id` and one of either `name` or `quick_connect_id` is required.
-
 This data source supports the following arguments:
 
 * `quick_connect_id` - (Optional) Returns information on a specific Quick Connect by Quick Connect id
 * `instance_id` - (Required) Reference to the hosting Amazon Connect Instance
 * `name` - (Optional) Returns information on a specific Quick Connect by name
 
+~> **NOTE:** `instance_id` and one of either `name` or `quick_connect_id` is required.
+
 ## Attribute Reference
 
 This data source exports the following attributes in addition to the arguments above:

website/docs/d/connect_routing_profile.html.markdown

@@ -32,14 +32,14 @@ data "aws_connect_routing_profile" "example" {
 
 ## Argument Reference
 
-~> **NOTE:** `instance_id` and one of either `name` or `routing_profile_id` is required.
-
 This data source supports the following arguments:
 
 * `instance_id` - Reference to the hosting Amazon Connect Instance
 * `name` - (Optional) Returns information on a specific Routing Profile by name
 * `routing_profile_id` - (Optional) Returns information on a specific Routing Profile by Routing Profile id
 
+~> **NOTE:** `instance_id` and one of either `name` or `routing_profile_id` is required.
+
 ## Attribute Reference
 
 This data source exports the following attributes in addition to the arguments above:

website/docs/d/connect_security_profile.html.markdown

@@ -32,14 +32,14 @@ data "aws_connect_security_profile" "example" {
 
 ## Argument Reference
 
-~> **NOTE:** `instance_id` and one of either `name` or `security_profile_id` is required.
-
 This data source supports the following arguments:
 
 * `security_profile_id` - (Optional) Returns information on a specific Security Profile by Security Profile id
 * `instance_id` - (Required) Reference to the hosting Amazon Connect Instance
 * `name` - (Optional) Returns information on a specific Security Profile by name
 
+~> **NOTE:** `instance_id` and one of either `name` or `security_profile_id` is required.
+
 ## Attribute Reference
 
 This data source exports the following attributes in addition to the arguments above:

website/docs/d/connect_user.html.markdown

@@ -32,14 +32,14 @@ data "aws_connect_user" "example" {
 
 ## Argument Reference
 
-~> **NOTE:** `instance_id` and one of either `name` or `user_id` is required.
-
 This data source supports the following arguments:
 
 * `instance_id` - (Required) Reference to the hosting Amazon Connect Instance
 * `name` - (Optional) Returns information on a specific User by name
 * `user_id` - (Optional) Returns information on a specific User by User id
 
+~> **NOTE:** `instance_id` and one of either `name` or `user_id` is required.
+
 ## Attribute Reference
 
 This data source exports the following attributes in addition to the arguments above:

website/docs/d/connect_user_hierarchy_group.html.markdown

@@ -32,14 +32,14 @@ data "aws_connect_user_hierarchy_group" "example" {
 
 ## Argument Reference
 
-~> **NOTE:** `instance_id` and one of either `name` or `hierarchy_group_id` is required.
-
 This data source supports the following arguments:
 
 * `hierarchy_group_id` - (Optional) Returns information on a specific hierarchy group by hierarchy group id
 * `instance_id` - (Required) Reference to the hosting Amazon Connect Instance
 * `name` - (Optional) Returns information on a specific hierarchy group by name
 
+~> **NOTE:** `instance_id` and one of either `name` or `hierarchy_group_id` is required.
+
 ## Attribute Reference
 
 This data source exports the following attributes in addition to the arguments above:

website/docs/d/connect_vocabulary.html.markdown

@@ -32,14 +32,14 @@ data "aws_connect_vocabulary" "example" {
 
 ## Argument Reference
 
-~> **NOTE:** `instance_id` and one of either `name` or `vocabulary_id` is required.
-
 This data source supports the following arguments:
 
 * `instance_id` - (Required) Reference to the hosting Amazon Connect Instance
 * `name` - (Optional) Returns information on a specific Vocabulary by name
 * `vocabulary_id` - (Optional) Returns information on a specific Vocabulary by Vocabulary id
 
+~> **NOTE:** `instance_id` and one of either `name` or `vocabulary_id` is required.
+
 ## Attribute Reference
 
 This data source exports the following attributes in addition to the arguments above:

website/docs/d/db_snapshot.html.markdown

@@ -47,8 +47,6 @@ resource "aws_db_instance" "dev" {
 
 ## Argument Reference
 
-~> **NOTE:** One of either `db_instance_identifier` or `db_snapshot_identifier` is required.
-
 This data source supports the following arguments:
 
 * `most_recent` - (Optional) If more than one result is returned, use the most
@@ -66,6 +64,8 @@ copied or restored by any AWS account, otherwise set this value to false. The de
 * `tags` - (Optional) Mapping of tags, each pair of which must exactly match
   a pair on the desired DB snapshot.
 
+~> **NOTE:** One of either `db_instance_identifier` or `db_snapshot_identifier` is required.
+
 ## Attribute Reference
 
 This data source exports the following attributes in addition to the arguments above:

website/docs/d/ec2_coip_pool.html.markdown

@@ -28,14 +28,10 @@ data "aws_ec2_coip_pool" "selected" {
 
 ## Argument Reference
 
-The arguments of this data source act as filters for querying the available
-COIP Pools in the current region. The given filters must match exactly one
-COIP Pool whose data will be exported as attributes.
+This data source supports the following arguments:
 
 * `local_gateway_route_table_id` - (Optional) Local Gateway Route Table Id assigned to desired COIP Pool
-
 * `pool_id` - (Optional) ID of the specific COIP Pool to retrieve.
-
 * `tags` - (Optional) Mapping of tags, each pair of which must exactly match
   a pair on the desired COIP Pool.
 
@@ -44,7 +40,6 @@ which take the following arguments:
 
 * `name` - (Required) Name of the field to filter by, as defined by
   [the underlying AWS API](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeCoipPools.html).
-
 * `values` - (Required) Set of values that are accepted for the given field.
   A COIP Pool will be selected if any one of the given values matches.
 

website/docs/d/instance.html.markdown

@@ -30,17 +30,15 @@ data "aws_instance" "foo" {
 
 ## Argument Reference
 
-* `instance_id` - (Optional) Specify the exact Instance ID with which to populate the data source.
+This data source supports the following arguments:
 
+* `instance_id` - (Optional) Specify the exact Instance ID with which to populate the data source.
 * `instance_tags` - (Optional) Map of tags, each pair of which must
 exactly match a pair on the desired Instance.
-
 * `filter` - (Optional) One or more name/value pairs to use as filters. There are
 several valid keys, for a full reference, check out
 [describe-instances in the AWS CLI reference][1].
-
 * `get_password_data` - (Optional) If true, wait for password data to become available and retrieve it. Useful for getting the administrator password for instances running Microsoft Windows. The password data is exported to the `password_data` attribute. See [GetPasswordData](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetPasswordData.html) for more information.
-
 * `get_user_data` - (Optional) Retrieve Base64 encoded User Data contents into the `user_data_base64` attribute. A SHA-1 hash of the User Data contents will always be present in the `user_data` attribute. Defaults to `false`.
 
 ~> **NOTE:** At least one of `filter`, `instance_tags`, or `instance_id` must be specified.

website/docs/d/internet_gateway.html.markdown

@@ -25,23 +25,18 @@ data "aws_internet_gateway" "default" {
 
 ## Argument Reference
 
-The arguments of this data source act as filters for querying the available
-Internet Gateway in the current region. The given filters must match exactly one
-Internet Gateway whose data will be exported as attributes.
+This data source supports the following arguments:
 
 * `internet_gateway_id` - (Optional) ID of the specific Internet Gateway to retrieve.
-
 * `tags` - (Optional) Map of tags, each pair of which must exactly match
   a pair on the desired Internet Gateway.
-
 * `filter` - (Optional) Custom filter block as described below.
 
 More complex filters can be expressed using one or more `filter` sub-blocks,
 which take the following arguments:
 
 * `name` - (Required) Name of the field to filter by, as defined by
   [the underlying AWS API](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInternetGateways.html).
-
 * `values` - (Required) Set of values that are accepted for the given field.
   An Internet Gateway will be selected if any one of the given values matches.
 

website/docs/d/route_table.html.markdown

@@ -32,9 +32,7 @@ resource "aws_route" "route" {
 
 ## Argument Reference
 
-The arguments of this data source act as filters for querying the available Route Table in the current region. The given filters must match exactly one Route Table whose data will be exported as attributes.
-
-The following arguments are optional:
+This data source supports the following arguments:
 
 * `filter` - (Optional) Configuration block. Detailed below.
 * `gateway_id` - (Optional) ID of an Internet Gateway or Virtual Private Gateway which is connected to the Route Table (not exported if not passed as a parameter).

website/docs/d/security_group.html.markdown

@@ -34,27 +34,20 @@ resource "aws_subnet" "subnet" {
 
 ## Argument Reference
 
-The arguments of this data source act as filters for querying the available
-security group in the current region. The given filters must match exactly one
-security group whose data will be exported as attributes.
+This data source supports the following arguments:
 
 * `filter` - (Optional) Custom filter block as described below.
-
 * `id` - (Optional) Id of the specific security group to retrieve.
-
 * `name` - (Optional) Name that the desired security group must have.
-
 * `tags` - (Optional) Map of tags, each pair of which must exactly match
   a pair on the desired security group.
-
 * `vpc_id` - (Optional) Id of the VPC that the desired security group belongs to.
 
 More complex filters can be expressed using one or more `filter` sub-blocks,
 which take the following arguments:
 
 * `name` - (Required) Name of the field to filter by, as defined by
   [the underlying AWS API](http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSecurityGroups.html).
-
 * `values` - (Required) Set of values that are accepted for the given field.
   A Security Group will be selected if any one of the given values matches.
 

website/docs/d/shield_protection.html.markdown

@@ -30,13 +30,13 @@ data "aws_shield_protection" "example" {
 
 ## Argument Reference
 
-~> Exactly one of `protection_id` or `resource_arn` is required.
-
-The following arguments are optional:
+This data source supports the following arguments:
 
 * `protection_id` - (Optional) Unique identifier for the protection.
 * `resource_arn` - (Optional) ARN (Amazon Resource Name) of the resource being protected.
 
+~> Exactly one of `protection_id` or `resource_arn` is required.
+
 ## Attribute Reference
 
 This data source exports the following attributes in addition to the arguments above:

website/docs/d/subnet.html.markdown

@@ -50,9 +50,7 @@ data "aws_subnet" "selected" {
 
 ## Argument Reference
 
-The arguments of this data source act as filters for querying the available subnets in the current region. The given filters must match exactly one subnet whose data will be exported as attributes.
-
-The following arguments are optional:
+This data source supports the following arguments:
 
 * `availability_zone` - (Optional) Availability zone where the subnet must reside.
 * `availability_zone_id` - (Optional) ID of the Availability Zone for the subnet. This argument is not supported in all regions or partitions. If necessary, use `availability_zone` instead.

website/docs/d/vpc.html.markdown

@@ -36,24 +36,16 @@ resource "aws_subnet" "example" {
 
 ## Argument Reference
 
-The arguments of this data source act as filters for querying the available
-VPCs in the current region. The given filters must match exactly one
-VPC whose data will be exported as attributes.
+This data source supports the following arguments:
 
 * `cidr_block` - (Optional) Cidr block of the desired VPC.
-
 * `dhcp_options_id` - (Optional) DHCP options id of the desired VPC.
-
 * `default` - (Optional) Boolean constraint on whether the desired VPC is
   the default VPC for the region.
-
 * `filter` - (Optional) Custom filter block as described below.
-
 * `id` - (Optional) ID of the specific VPC to retrieve.
-
 * `state` - (Optional) Current state of the desired VPC.
   Can be either `"pending"` or `"available"`.
-
 * `tags` - (Optional) Map of tags, each pair of which must exactly match
   a pair on the desired VPC.
 
@@ -62,7 +54,6 @@ which take the following arguments:
 
 * `name` - (Required) Name of the field to filter by, as defined by
   [the underlying AWS API](http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVpcs.html).
-
 * `values` - (Required) Set of values that are accepted for the given field.
   A VPC will be selected if any one of the given values matches.
 

website/docs/d/vpc_endpoint_service.html.markdown

@@ -55,8 +55,7 @@ data "aws_vpc_endpoint_service" "test" {
 
 ## Argument Reference
 
-The arguments of this data source act as filters for querying the available VPC endpoint services.
-The given filters must match exactly one VPC endpoint service whose data will be exported as attributes.
+This data source supports the following arguments:
 
 * `filter` - (Optional) Configuration block(s) for filtering. Detailed below.
 * `service` - (Optional) Common name of an AWS service (e.g., `s3`).