Edit docs

Author: SharaevN

docs/data-sources/project_milestone.md

@@ -34,7 +34,7 @@ data "gitlab_project_milestone" "example" {
 
 ### Required
 
-- `milestone_id` (Number) The ID of the project’s milestone in Gitlab DB.
+- `milestone_id` (Number) The global ID of the project’s milestone.
 - `project_id` (String) The ID or URL-encoded path of the project owned by the authenticated user.
 
 ### Optional
@@ -43,15 +43,15 @@ data "gitlab_project_milestone" "example" {
 
 ### Read-Only
 
-- `created_at` (String) The time of creation of the milestone.
+- `created_at` (String) The time of creation of the milestone. Date time string, ISO 8601 formatted, for example 2016-03-11T03:45:40Z.
 - `description` (String) The description of the milestone.
-- `due_date` (String) The due date of the milestone.
+- `due_date` (String) The due date of the milestone. Date time string in the format YYYY-MM-DD, for example 2016-03-11.
 - `expired` (Boolean) Bool, true if milestore expired.
-- `iid` (Number) The ID of the project’s milestone.
-- `start_date` (String) The start date of the milestone.
+- `iid` (Number) The ID of the milestone only in one project.
+- `start_date` (String) The start date of the milestone. Date time string in the format YYYY-MM-DD, for example 2016-03-11.
 - `state` (String) The state of the milestone. Valid values are: `active`, `closed`.
 - `title` (String) The title of a milestone.
-- `updated_at` (String) The last update time of the milestone.
+- `updated_at` (String) The last update time of the milestone. Date time string, ISO 8601 formatted, for example 2016-03-11T03:45:40Z.
 - `web_url` (String) The web URL of the milestone.
 
 

docs/resources/project_milestone.md

@@ -39,19 +39,19 @@ resource "gitlab_project_milestone" "example" {
 
 ### Optional
 
-- `created_at` (String) The time of creation of the milestone.
+- `created_at` (String) The time of creation of the milestone. Date time string, ISO 8601 formatted, for example 2016-03-11T03:45:40Z.
 - `description` (String) The description of the milestone.
-- `due_date` (String) The due date of the milestone.
+- `due_date` (String) The due date of the milestone. Date time string in the format YYYY-MM-DD, for example 2016-03-11.
 - `id` (String) The ID of this resource.
-- `start_date` (String) The start date of the milestone.
+- `start_date` (String) The start date of the milestone. Date time string in the format YYYY-MM-DD, for example 2016-03-11.
 - `state` (String) The state of the milestone. Valid values are: `active`, `closed`.
-- `updated_at` (String) The last update time of the milestone.
+- `updated_at` (String) The last update time of the milestone. Date time string, ISO 8601 formatted, for example 2016-03-11T03:45:40Z.
 
 ### Read-Only
 
 - `expired` (Boolean) Bool, true if milestore expired.
-- `iid` (Number) The ID of the project’s milestone.
-- `milestone_id` (Number) The ID of the project’s milestone in Gitlab DB.
+- `iid` (Number) The ID of the milestone only in one project.
+- `milestone_id` (Number) The global ID of the project’s milestone.
 - `web_url` (String) The web URL of the milestone.
 
 ## Import

internal/provider/schema_gitlab_project_milestone.go

@@ -14,12 +14,12 @@ func gitlabProjectMilestoneGetSchema() map[string]*schema.Schema {
 
 	return map[string]*schema.Schema{
 		"iid": {
-			Description: "The ID of the project’s milestone.",
+			Description: "The ID of the milestone only in one project.",
 			Type:        schema.TypeInt,
 			Computed:    true,
 		},
 		"milestone_id": {
-			Description: "The ID of the project’s milestone in Gitlab DB.",
+			Description: "The global ID of the project’s milestone.",
 			Type:        schema.TypeInt,
 			Computed:    true,
 		},
@@ -40,19 +40,19 @@ func gitlabProjectMilestoneGetSchema() map[string]*schema.Schema {
 			Optional:    true,
 		},
 		"due_date": {
-			Description:      "The due date of the milestone.",
+			Description:      "The due date of the milestone. Date time string in the format YYYY-MM-DD, for example 2016-03-11.",
 			Type:             schema.TypeString,
 			Optional:         true,
 			ValidateDiagFunc: isISO6801Date,
 		},
 		"start_date": {
-			Description:      "The start date of the milestone.",
+			Description:      "The start date of the milestone. Date time string in the format YYYY-MM-DD, for example 2016-03-11.",
 			Type:             schema.TypeString,
 			Optional:         true,
 			ValidateDiagFunc: isISO6801Date,
 		},
 		"updated_at": {
-			Description: "The last update time of the milestone.",
+			Description: "The last update time of the milestone. Date time string, ISO 8601 formatted, for example 2016-03-11T03:45:40Z.",
 			Type:        schema.TypeString,
 			Computed:    true,
 			Optional:    true,
@@ -61,7 +61,7 @@ func gitlabProjectMilestoneGetSchema() map[string]*schema.Schema {
 			ValidateDiagFunc: validation.ToDiagFunc(validation.IsRFC3339Time),
 		},
 		"created_at": {
-			Description: "The time of creation of the milestone.",
+			Description: "The time of creation of the milestone. Date time string, ISO 8601 formatted, for example 2016-03-11T03:45:40Z.",
 			Type:        schema.TypeString,
 			Computed:    true,
 			Optional:    true,