Generate docs

Author: julienduchesne

docs/data-sources/user.md

@@ -0,0 +1,58 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "grafana_user Data Source - terraform-provider-grafana"
+subcategory: ""
+description: |-
+  Official documentation https://grafana.com/docs/grafana/latest/manage-users/server-admin/server-admin-manage-users/HTTP API https://grafana.com/docs/grafana/latest/http_api/user/
+  This resource uses Grafana's admin APIs for creating and updating users which
+  does not currently work with API Tokens. You must use basic auth.
+---
+
+# grafana_user (Data Source)
+
+* [Official documentation](https://grafana.com/docs/grafana/latest/manage-users/server-admin/server-admin-manage-users/)
+* [HTTP API](https://grafana.com/docs/grafana/latest/http_api/user/)
+
+This resource uses Grafana's admin APIs for creating and updating users which
+does not currently work with API Tokens. You must use basic auth.
+
+## Example Usage
+
+```terraform
+resource "grafana_user" "test" {
+  email    = "[email protected]"
+  name     = "Testing Datasource"
+  login    = "test-datasource"
+  password = "my-password"
+  is_admin = true
+}
+
+data "grafana_user" "from_id" {
+  user_id = grafana_user.test.user_id
+}
+
+data "grafana_user" "from_email" {
+  email = grafana_user.test.email
+}
+
+data "grafana_user" "from_login" {
+  login = grafana_user.test.login
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Optional
+
+- **email** (String) The email address of the Grafana user. Defaults to ``.
+- **id** (String) The ID of this resource.
+- **login** (String) The username for the Grafana user. Defaults to ``.
+- **user_id** (Number) The numerical ID of the Grafana user. Defaults to `-1`.
+
+### Read-Only
+
+- **is_admin** (Boolean) Whether the user is an admin.
+- **name** (String) The display name for the Grafana user.
+
+

docs/index.md

@@ -32,6 +32,7 @@ provider "grafana" {
 - **ca_cert** (String) Certificate CA bundle to use to verify the Grafana server's certificate. May alternatively be set via the `GRAFANA_CA_CERT` environment variable.
 - **insecure_skip_verify** (Boolean) Skip TLS certificate verification. May alternatively be set via the `GRAFANA_INSECURE_SKIP_VERIFY` environment variable.
 - **org_id** (Number) The organization id to operate on within grafana. May alternatively be set via the `GRAFANA_ORG_ID` environment variable.
+- **retries** (Number) The amount of retries to use for Grafana API calls. May alternatively be set via the `GRAFANA_RETRIES` environment variable.
 - **sm_access_token** (String, Sensitive) A Synthetic Monitoring access token. May alternatively be set via the `GRAFANA_SM_ACCESS_TOKEN` environment variable.
 - **sm_url** (String) Synthetic monitoring backend address. May alternatively be set via the `GRAFANA_SM_URL` environment variable.
 - **tls_cert** (String) Client TLS certificate file to use to authenticate to the Grafana server. May alternatively be set via the `GRAFANA_TLS_CERT` environment variable.

docs/resources/user.md

@@ -43,6 +43,10 @@ resource "grafana_user" "staff" {
 - **login** (String) The username for the Grafana user.
 - **name** (String) The display name for the Grafana user.
 
+### Read-Only
+
+- **user_id** (Number) The numerical ID of the Grafana user.
+
 ## Import
 
 Import is supported using the following syntax:

grafana/data_source_user.go

@@ -21,9 +21,10 @@ does not currently work with API Tokens. You must use basic auth.
 		ReadContext: dataSourceUserRead,
 		Schema: map[string]*schema.Schema{
 			"user_id": {
-				Type:     schema.TypeInt,
-				Optional: true,
-				Default:  -1,
+				Type:        schema.TypeInt,
+				Optional:    true,
+				Default:     -1,
+				Description: "The numerical ID of the Grafana user.",
 			},
 			"email": {
 				Type:        schema.TypeString,

grafana/resource_user.go

@@ -30,8 +30,9 @@ does not currently work with API Tokens. You must use basic auth.
 		},
 		Schema: map[string]*schema.Schema{
 			"user_id": {
-				Type:     schema.TypeInt,
-				Computed: true,
+				Type:        schema.TypeInt,
+				Computed:    true,
+				Description: "The numerical ID of the Grafana user.",
 			},
 			"email": {
 				Type:        schema.TypeString,