Document BQ role behavior. (#4191) (#2678)

Signed-off-by: Modular Magician <[email protected]>

Author: modular-magician

.changelog/4191.txt

@@ -0,0 +1,3 @@
+```release-note:none
+
+```

website/docs/r/bigquery_dataset.html.markdown

@@ -31,6 +31,10 @@ To get more information about Dataset, see:
 * How-to Guides
     * [Datasets Intro](https://cloud.google.com/bigquery/docs/datasets-intro)
 
+~> **Warning:** You must specify the role field using the legacy format `OWNER` instead of `roles/bigquery.dataOwner`. 
+The API does accept both formats but it will always return the legacy format which results in Terraform
+showing permanent diff on each plan and apply operation.
+
 <div class = "oics-button" style="float: right; margin: 0 0 -15px">
   <a href="https://console.cloud.google.com/cloudshell/open?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Fterraform-google-modules%2Fdocs-examples.git&cloudshell_working_dir=bigquery_dataset_basic&cloudshell_image=gcr.io%2Fgraphite-cloud-shell-images%2Fterraform%3Alatest&open_in_editor=main.tf&cloudshell_print=.%2Fmotd&cloudshell_tutorial=.%2Ftutorial.md" target="_blank">
     <img alt="Open in Cloud Shell" src="//gstatic.com/cloudssh/images/open-btn.svg" style="max-height: 44px; margin: 32px auto; max-width: 100%;">

website/docs/r/bigquery_dataset_access.html.markdown

@@ -37,6 +37,10 @@ To get more information about DatasetAccess, see:
 * How-to Guides
     * [Controlling access to datasets](https://cloud.google.com/bigquery/docs/dataset-access-controls)
 
+~> **Warning:** You must specify the role field using the legacy format `OWNER` instead of `roles/bigquery.dataOwner`. 
+The API does accept both formats but it will always return the legacy format which results in Terraform
+showing permanent diff on each plan and apply operation.
+
 ## Example Usage - Bigquery Dataset Access Basic User
 
 

website/docs/r/bigquery_job.html.markdown

@@ -26,6 +26,11 @@ Jobs are actions that BigQuery runs on your behalf to load data, export data, qu
 Once a BigQuery job is created, it cannot be changed or deleted.
 
 
+To get more information about Job, see:
+
+* [API documentation](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs)
+* How-to Guides
+    * [BigQuery Jobs Intro](https://cloud.google.com/bigquery/docs/jobs-overview)
 
 <div class = "oics-button" style="float: right; margin: 0 0 -15px">
   <a href="https://console.cloud.google.com/cloudshell/open?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Fterraform-google-modules%2Fdocs-examples.git&cloudshell_working_dir=bigquery_job_query&cloudshell_image=gcr.io%2Fgraphite-cloud-shell-images%2Fterraform%3Alatest&open_in_editor=main.tf&cloudshell_print=.%2Fmotd&cloudshell_tutorial=.%2Ftutorial.md" target="_blank">