Add DTD docs

Signed-off-by: Andy Lo-A-Foe <andy.loafoe@gmail.com>

Author: loafoe

docs/data-sources/cdl_data_type_definition.md

@@ -0,0 +1,35 @@
+# hsdp_cdl_data_type_definition
+
+Retrieve details on HSDP Clinical Data Lake Data Type Definition.
+
+## Example Usage
+
+```hcl
+data "hsdp_cdl_data_type_definition" "def_a" {
+  cdl_endpoint = data.cdl_instance.cicd.endpoint
+  dtd_id = var.dtd_id
+} 
+
+output "schema" {
+  value = data.hsdp_cdl_data_type_definition.def_a.json_schema
+}
+```
+
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `cdl_endpoint` - (Required) The CDL instance endpoint to query
+* `dtd_id` - (Required) The ID of the DTD to look up
+
+## Attributes Reference
+
+In addition to all arguments above, the following attributes are exported:
+
+* `id` - The GUID of the DTDT
+* `json_schema` -  The JSON schema describing the DTD
+* `created_by` - Which entity created the DTD
+* `created_on` - When the DTD was created
+* `updated_by` - Which entity updated the DTD last
+* `updated_on` - When the DTD was updated

docs/data-sources/cdl_data_type_definitions.md

@@ -0,0 +1,28 @@
+# hsdp_cdl_data_type_definitions
+
+Retrieve DTDs present in a HSDP Clinical Data Lake instance.
+
+## Example Usage
+
+```hcl
+data "hsdp_cdl_data_type_definitions" "all" {
+  cdl_endpoint = data.cdl_instance.cicd.endpoint
+} 
+
+output "all_study_titles" {
+  value = data.hsdp_cdl_research_studies.all.titles
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `cdl_endpoint` - (Required) The CDL instance endpoint to query
+
+## Attributes Reference
+
+In addition to all arguments above, the following attributes are exported:
+
+* `ids` -  The list of DTD GUIDs
+* `names` - The names of the DTDs. This matches up with the `ids` list

docs/resources/cdl_data_type_definition.md

@@ -0,0 +1,36 @@
+# hsdp_cdl_data_type_definition
+
+Manages HSDP Clinical Data Lake Data Type Definitions.
+
+## Example Usage
+
+```hcl
+resource "hsdp_cdl_data_type_definition" "def_a" {
+  cdl_endpoint = data.cdl_instance.cicd.endpoint
+  name = "my CDL schema A"
+  
+  json_schema = <<EOF
+{}
+EOF
+}
+```
+
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `cdl_endpoint` - (Required) The CDL instance endpoint to query
+* `name` - (Required) The name of the DTD
+* `description` - (Optional) The description of the DTD
+* `json_schema` - (Optional) The JSON Schema describing the DTD
+
+## Attributes Reference
+
+In addition to all arguments above, the following attributes are exported:
+
+* `id` - The GUID of the DTDT
+* `created_by` - Which entity created the DTD
+* `created_on` - When the DTD was created
+* `updated_by` - Which entity updated the DTD last
+* `updated_on` - When the DTD was updated

…p/data_source_cdl_datatype_definition.go …/data_source_cdl_data_type_definition.gohsdp/data_source_cdl_datatype_definition.go renamed to hsdp/data_source_cdl_data_type_definition.go hsdp/data_source_cdl_datatype_definition.go renamed to hsdp/data_source_cdl_data_type_definition.go

@@ -3,6 +3,7 @@ package hsdp
 import (
 	"context"
 	"encoding/json"
+
 	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
 	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
 )
@@ -44,7 +45,7 @@ func dataSourceCDLDataTypeDefinition() *schema.Resource {
 
 }
 
-func dataSourceCDLDataTypeDefinitionRead(ctx context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
+func dataSourceCDLDataTypeDefinitionRead(_ context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
 	config := m.(*Config)
 
 	var diags diag.Diagnostics

…/data_source_cdl_datatype_definitions.go …data_source_cdl_data_type_definitions.gohsdp/data_source_cdl_datatype_definitions.go renamed to hsdp/data_source_cdl_data_type_definitions.go hsdp/data_source_cdl_datatype_definitions.go renamed to hsdp/data_source_cdl_data_type_definitions.go

@@ -2,6 +2,7 @@ package hsdp
 
 import (
 	"context"
+
 	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
 	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
 	"github.com/philips-software/go-hsdp-api/cdl"
@@ -30,7 +31,7 @@ func dataSourceCDLDataTypeDefinitions() *schema.Resource {
 
 }
 
-func dataSourceCDLDataTypeDefinitionsRead(ctx context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
+func dataSourceCDLDataTypeDefinitionsRead(_ context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
 	config := m.(*Config)
 
 	var diags diag.Diagnostics

hsdp/resource_cdl_datatype_definition.go hsdp/resource_cdl_data_type_definition.gohsdp/resource_cdl_datatype_definition.go renamed to hsdp/resource_cdl_data_type_definition.go

@@ -4,10 +4,11 @@ import (
 	"context"
 	"encoding/json"
 	"fmt"
+	"net/http"
+
 	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
 	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
 	"github.com/philips-software/go-hsdp-api/cdl"
-	"net/http"
 )
 
 func resourceCDLDataTypeDefinition() *schema.Resource {
@@ -43,14 +44,14 @@ func resourceCDLDataTypeDefinition() *schema.Resource {
 	}
 }
 
-func resourceCDLDataTypeDefinitionDelete(ctx context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
+func resourceCDLDataTypeDefinitionDelete(_ context.Context, d *schema.ResourceData, _ interface{}) diag.Diagnostics {
 	var diags diag.Diagnostics
 
 	d.SetId("") // This is by design currently
 	return diags
 }
 
-func resourceCDLDataTypeDefinitionUpdate(ctx context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
+func resourceCDLDataTypeDefinitionUpdate(_ context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
 	config := m.(*Config)
 	var diags diag.Diagnostics
 
@@ -127,7 +128,7 @@ func resourceCDLDataTypeDefinitionCreate(ctx context.Context, d *schema.Resource
 	return resourceCDLDataTypeDefinitionRead(ctx, d, m)
 }
 
-func resourceCDLDataTypeDefinitionRead(ctx context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
+func resourceCDLDataTypeDefinitionRead(_ context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
 	config := m.(*Config)
 
 	var diags diag.Diagnostics