Better documentation for how a resourceref works (#96)

<!-- This change is generated by MagicModules. -->
/cc @rambleraptor

plugins/modules/gcp_compute_target_tcp_proxy.py

@@ -43,41 +43,33 @@ requirements:
 options:
   state:
     description:
-    - Whether the given object should exist in GCP
-    choices:
-    - present
-    - absent
-    default: present
-  description:
-    description:
-    - An optional description of this resource.
-    required: false
-  name:
-    description:
-    - Name of the resource. Provided by the client when the resource is created. The
-      name must be 1-63 characters long, and comply with RFC1035. Specifically, the
-      name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`
-      which means the first character must be a lowercase letter, and all following
-      characters must be a dash, lowercase letter, or digit, except the last character,
-      which cannot be a dash.
-    required: true
-  proxy_header:
-    description:
-    - Specifies the type of proxy header to append before sending data to the backend,
-      either NONE or PROXY_V1. The default is NONE.
-    required: false
-    choices:
-    - NONE
-    - PROXY_V1
-  service:
-    description:
-    - A reference to the BackendService resource.
-    - 'This field represents a link to a BackendService resource in GCP. It can be
-      specified in two ways. First, you can place a dictionary with key ''selfLink''
-      and value of your resource''s selfLink Alternatively, you can add `register:
-      name-of-resource` to a gcp_compute_backend_service task and then set this service
-      field to "{{ name-of-resource }}"'
-    required: true
+        description:
+            - An optional description of this resource.
+        required: false
+    name:
+        description:
+            - Name of the resource. Provided by the client when the resource is created. The name
+              must be 1-63 characters long, and comply with RFC1035. Specifically, the name must
+              be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`
+              which means the first character must be a lowercase letter, and all following characters
+              must be a dash, lowercase letter, or digit, except the last character, which cannot
+              be a dash.
+        required: true
+    proxy_header:
+        description:
+            - Specifies the type of proxy header to append before sending data to the backend,
+              either NONE or PROXY_V1. The default is NONE.
+        required: false
+        choices: ['NONE', 'PROXY_V1']
+    service:
+        description:
+            - A reference to the BackendService resource.
+            - 'This field represents a link to a BackendService resource in GCP. It can be specified
+              in two ways. You can add `register: name-of-resource` to a gcp_compute_backend_service
+              task and then set this service field to "{{ name-of-resource }}" Alternatively,
+              you can set this service to a dictionary with the selfLink key where the value is
+              the selfLink of your BackendService.'
+        required: true
 extends_documentation_fragment: gcp
 notes:
 - 'API Reference: U(https://cloud.google.com/compute/docs/reference/v1/targetTcpProxies)'