docs: Improve docker network usage documentation [skip-ci]

docs/resources/container.md

@@ -220,7 +220,7 @@ Required:
 
 Required:
 
-- `name` (String) The name of the network.
+- `name` (String) The name or id of the network to use. You can use `name` or `id` attribute from a `docker_network` resource.
 
 Optional:
 

docs/resources/network.md

@@ -3,12 +3,12 @@
 page_title: "Resource docker_network - terraform-provider-docker"
 subcategory: ""
 description: |-
-  docker_network provides details about a specific Docker Network.
+  docker_network provides a docker network resource.
 ---
 <!-- Bug: Type and Name are switched -->
 # Resource (docker_network)
 
-`docker_network` provides details about a specific Docker Network.
+`docker_network` provides a docker network resource.
 
 ## Example Usage
 

internal/provider/resource_docker_container.go

@@ -788,7 +788,7 @@ func resourceDockerContainer() *schema.Resource {
 					Schema: map[string]*schema.Schema{
 						"name": {
 							Type:        schema.TypeString,
-							Description: "The name of the network.",
+							Description: "The name or id of the network to use. You can use `name` or `id` attribute from a `docker_network` resource.",
 							Required:    true,
 							ForceNew:    true,
 						},

internal/provider/resource_docker_network.go

@@ -12,7 +12,7 @@ import (
 
 func resourceDockerNetwork() *schema.Resource {
 	return &schema.Resource{
-		Description: "`docker_network` provides details about a specific Docker Network.",
+		Description: "`docker_network` provides a docker network resource.",
 
 		CreateContext: resourceDockerNetworkCreate,
 		ReadContext:   resourceDockerNetworkRead,