docs update

Author: David Kraushuber

docs/data-sources/customdeclaration.md

@@ -0,0 +1,24 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "simplemdm_customdeclaration Data Source - simplemdm"
+subcategory: ""
+description: |-
+  Custom Declaration data source can be used together with Device(s) or Device Group(s) to set values or in lifecycle management.
+---
+
+# simplemdm_customdeclaration (Data Source)
+
+Custom Declaration data source can be used together with Device(s) or Device Group(s) to set values or in lifecycle management.
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `id` (String) ID of the custom Declaration.
+
+### Read-Only
+
+- `name` (String) Default (global) value of the Attribute.

docs/index.md

@@ -1,7 +1,6 @@
 ---
 # generated by https://github.com/hashicorp/terraform-plugin-docs
 page_title: "simplemdm Provider"
-subcategory: ""
 description: |-
   SimpleMDM terraform provider developed by FreeNow.
 ---

docs/resources/app.md

@@ -19,6 +19,13 @@ resource "simplemdm_app" "app" {
 }
 ```
 
+```terraform
+resource "simplemdm_app" "app" {
+  bundle_id = "com.myCompany.MyApp1"
+  deploy_to = "all" // Default to "none" if not added but possible values are "outdated" and "all"
+}
+```
+
 <!-- schema generated by tfplugindocs -->
 ## Schema
 
@@ -37,6 +44,8 @@ resource "simplemdm_app" "app" {
 
 Import is supported using the following syntax:
 
+The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:
+
 ```shell
 # App can be imported by specifying the app ID.
 terraform import simplemdm_app.example 123456

docs/resources/assignmentgroup.md

@@ -59,6 +59,8 @@ resource "simplemdm_assignmentgroup" "myfirstgroup" {
 
 Import is supported using the following syntax:
 
+The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:
+
 ```shell
 # Assignment group can be imported by specifying the Assigntment group ID.
 terraform import simplemdm_assigntmentgroup.example 123456

docs/resources/attribute.md

@@ -38,6 +38,8 @@ resource "simplemdm_attribute" "myattribute" {
 
 Import is supported using the following syntax:
 
+The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:
+
 ```shell
 # Attribute can be imported by specifying the name of attribute.
 terraform import simplemdm_attribute.example myattributename

docs/resources/customdeclaration.md

@@ -0,0 +1,45 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "simplemdm_customdeclaration Resource - simplemdm"
+subcategory: ""
+description: |-
+  Custom Declaration resource can be used to manage Custom Declaration. Can be used together with Device(s) and Group(s) and set addition details regarding Custom Declaration.
+---
+
+# simplemdm_customdeclaration (Resource)
+
+Custom Declaration resource can be used to manage Custom Declaration. Can be used together with Device(s) and Group(s) and set addition details regarding Custom Declaration.
+
+## Example Usage
+
+```terraform
+resource "simplemdm_customdeclaration" "test" {
+  name                 = "testdeclaration"
+  declaration          = jsonencode(jsondecode(file("./testfiles/testdeclaration.json")))
+  userscope            = true
+  attributesupport     = true
+  escapeattributes     = true
+  declaration_type     = "com.apple.configuration.safari.bookmarks"
+  activation_predicate = ""
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `declaration` (String) Required. Can be string or you can use function 'file' or 'templatefile' to load string from file (see examples folder). Example: declaration = file("./declarations/declaration.json") or declaration = <<-EOT DECLARATION STRING EOT
+- `declaration_type` (String) Required. The type of declaration being defined
+- `name` (String) Required. A name for the declaration. Example: "My First declaration by terraform"
+
+### Optional
+
+- `activation_predicate` (String) Optional. A predicate format string as Apple's Predicate Programming describes. The activation only installs when the predicate evaluates to true or if it is left blank.
+- `attributesupport` (Boolean) Optional. A boolean true or false. When enabled, SimpleMDM will process variables in the uploaded declaration. Defaults to false
+- `escapeattributes` (Boolean) Optional. A boolean true or false. When enabled, SimpleMDM escape the values of the custom variables in the uploaded declaration. Defaults to false
+- `userscope` (Boolean) Optional. A boolean true or false. If false, deploy as a device declaration instead of a user declaration for macOS devices. Defaults to true.
+
+### Read-Only
+
+- `id` (String) ID of a Custom Declaration in SimpleMDM

docs/resources/customprofile.md

@@ -23,6 +23,37 @@ resource "simplemdm_customprofile" "myprofile" {
 }
 ```
 
+```terraform
+resource "simplemdm_customprofile" "myprofile" {
+  name                   = "My First profiles"
+  mobileconfig           = templatefile("./profiles/profile.mobileconfig", { foo = "bar" })
+  userscope              = true
+  attributesupport       = true
+  escapeattributes       = true
+  reinstallafterosupdate = false
+}
+```
+
+```terraform
+resource "simplemdm_customprofile" "myprofile" {
+  name                   = "My First profiles"
+  mobileconfig           = <<-EOT
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+    <dict>
+        <key>PayloadIdentifier</key>
+	.....redacted....
+ </dict>
+ </plist>
+EOT
+  userscope              = true
+  attributesupport       = true
+  escapeattributes       = true
+  reinstallafterosupdate = false
+}
+```
+
 <!-- schema generated by tfplugindocs -->
 ## Schema
 
@@ -46,6 +77,8 @@ resource "simplemdm_customprofile" "myprofile" {
 
 Import is supported using the following syntax:
 
+The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:
+
 ```shell
 # Custom profile can be imported by specifying the custom profile ID.
 terraform import simplemdm_customprofile.example 123456

docs/resources/device.md

@@ -50,6 +50,8 @@ resource "simplemdm_device" "firstdevice" {
 
 Import is supported using the following syntax:
 
+The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:
+
 ```shell
 # Device can be imported by specifying the device ID.
 terraform import simplemdm_device.example 123456

docs/resources/devicegroup.md

@@ -44,6 +44,8 @@ resource "simplemdm_devicegroup" "testgroup" {
 
 Import is supported using the following syntax:
 
+The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:
+
 ```shell
 # devicegroup can be imported by specifying the numeric identifier.
 terraform import simplemdm_devicegroup.example 123456

docs/resources/script.md

@@ -45,6 +45,8 @@ resource "simplemdm_script" "test" {
 
 Import is supported using the following syntax:
 
+The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:
+
 ```shell
 # devicegroup can be imported by specifying the numeric identifier.
 terraform import simplemdm_script.example 123456