Add templates and update documentation for RMON resources

Added new templates for various RMON resources including agent, user, group, and server. Updated documentation to provide clear examples and usage guidelines, reflecting the latest schema and import features for Terraform v1.7.0 and later.

Author: Aidaho12

Diff for: docs/data-sources/group.md

@@ -3,16 +3,41 @@
 page_title: "rmon_group Data Source - rmon"
 subcategory: ""
 description: |-
-  Represent roxy-wi group. All servers managed via RMON can be included in groups. A group is a user-defined pool of servers. By default, all your servers are included in the common group named Default.
+  Represent RMON group. All servers managed via RMON can be included in groups. A group is a user-defined pool of servers. By default, all your servers are included in the common group named Default.
 ---
 
 # rmon_group (Data Source)
 
-Represent roxy-wi group. All servers managed via RMON can be included in groups. A group is a user-defined pool of servers. By default, all your servers are included in the common group named Default.
+Represent RMON group. All servers managed via RMON can be included in groups. A group is a user-defined pool of servers. By default, all your servers are included in the common group named Default.
 
+## Example Usage
 
+```terraform
+provider "rmon" {
+  base_url = "https://..."
+  login    = "test"
+  password = "testpass"
+}
+
+data "rmon_group" "example_id" {
+  id = "4"
+}
+
+output "view" {
+  value = data.rmon_group.example_id
+}
+
+// ------------------------------------
+
+data "rmon_group" "example_name" {
+  name = "test"
+}
+
+output "data" {
+  value = data.rmon_group.example_name
+}
+```
 
-<!-- schema generated by tfplugindocs -->
 ## Schema
 
 ### Optional

Diff for: docs/data-sources/user_role.md

@@ -10,9 +10,22 @@ description: |-
 
 The data source allows you to retrieve information about user roles in RMON. This data source fetches a list of roles, providing details about each role's ID, name, and description.
 
+## Example Usage
 
+```terraform
+provider "rmon" {
+  base_url = "https://..."
+  login    = "test"
+  password = "testpass"
+}
+
+data "rmon_user_role" "example" {}
+
+output "test" {
+  value = data.rmon_user_role.example.roles
+}
+```
 
-<!-- schema generated by tfplugindocs -->
 ## Schema
 
 ### Read-Only
@@ -21,10 +34,11 @@ The data source allows you to retrieve information about user roles in RMON. Thi
 - `roles` (List of Object) List of roles. (see [below for nested schema](#nestedatt--roles))
 
 <a id="nestedatt--roles"></a>
+
 ### Nested Schema for `roles`
 
 Read-Only:
 
-- `description` (String)
-- `name` (String)
-- `role_id` (String)
+- `description` (String) The description of the user role.
+- `name` (String) The name of the user role.
+- `role_id` (String) The ID of the user role.

Diff for: docs/index.md

@@ -1,22 +1,66 @@
 ---
 # generated by https://github.com/hashicorp/terraform-plugin-docs
-page_title: "rmon Provider"
+page_title: "RMON Provider"
 subcategory: ""
 description: |-
   
 ---
 
-# rmon Provider
+# RMON Provider
 
+Use the RMON provider to interact with the many resources supported by RMON. You must configure the provider with the proper credentials before you can use it.
 
+Use the navigation to the left to read about the available resources.
 
+To learn the basics of Terraform using this provider, follow the hands-on get started tutorials.
 
+## Example Usage
+
+Terraform 1.7.0 and later:
+
+```terraform
+terraform {
+  required_providers {
+    rmon = {
+      source = "Roxy-wi/rmon"
+    }
+  }
+}
+
+provider "rmon" {
+  base_url = "https://..."
+  login    = "test"
+  password = "testpass"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
+
+### Provider Configuration
+
+!> **Warning:** Hard-coded credentials are not recommended in any Terraform configuration and risks secret leakage should this file ever be committed to a public version control system.
+
+### Environment Variables
+
+Credentials can be provided by using the `RMON_USERNAME`, `RMON_PASSWORD` and url auth `RMON_BASE_URL` environment variables.
+
+For example:
+
+```terraform
+provider "rmon" {}
+```
+
+```shell
+% export RMON_USERNAME="user"
+% export RMON_PASSWORD="password"
+% export RMON_BASE_URL="https://your_rmon"
+% terraform plan
+```
+
 ## Schema
 
 ### Required
 
-- `base_url` (String) URL to connect for RMON.
 - `login` (String) Username for RMON.
 - `password` (String) Password for RMON.
+- `base_url` (String) URL to connect for RMON.

Diff for: docs/resources/agent.md

@@ -10,10 +10,29 @@ description: |-
 
 This resource manages Agents in RMON.
 
+## Example Usage
 
+```terraform
+provider "rmon" {
+  base_url = "https://..."
+  login    = "test"
+  password = "testpass"
+}
 
-<!-- schema generated by tfplugindocs -->
-## Schema
+resource "rmon_agent" "example" {
+  server_id   = 1
+  name        = "Agent01"
+  description = "Agent in my DC"
+  enabled     = true
+  shared      = true
+  port        = 5101
+  region_id   = 1
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
 
 ### Required
 
@@ -41,3 +60,21 @@ Optional:
 - `create` (String)
 - `delete` (String)
 - `update` (String)
+
+
+## Import
+
+In Terraform v1.7.0 and later, use an import block to import Agent. For example:
+
+```terraform
+import {
+  to = rmon_agent.example
+  id = "1"
+}
+```
+
+Using terraform import, import Agent can be imported using the `id`, e.g. For example:
+
+```shell
+% terraform import rmon_agent.example 1
+```

Diff for: docs/resources/channel.md

@@ -10,31 +10,69 @@ description: |-
 
 Represents a communication channel such as Telegram, Slack, PagerDuty, or Mattermost.
 
+## Example Usage
 
+```terraform
+provider "rmon" {
+  base_url = "https://your_rmon"
+  login    = "testlog"
+  password = "testpass"
+}
 
-<!-- schema generated by tfplugindocs -->
-## Schema
+resource "rmon_channel" "example" {
+  receiver = "pd"
+  channel  = "test_my_channel"
+  group_id = 1
+  token    = "some_token"
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
 
 ### Required
 
 - `channel` (String) The channel identifier.
 - `group_id` (Number) The ID of the group to which the channel belongs.
-- `receiver` (String) The type of the receiver. Only `telegram`, `slack`, `pd`, `mm` are allowed.
+- `receiver` (String, ForceNew) The type of the receiver. Only `telegram`, `slack`, `pd`, `mm` are allowed.
 - `token` (String) The token used for the channel.
 
 ### Optional
 
 - `timeouts` (Block, Optional) (see [below for nested schema](#nestedblock--timeouts))
 
-### Read-Only
-
-- `id` (String) The ID of this resource.
-
 <a id="nestedblock--timeouts"></a>
+
 ### Nested Schema for `timeouts`
 
+This resource supports the following timeouts:
+
 Optional:
 
-- `create` (String)
-- `delete` (String)
-- `update` (String)
+* `create` - Default is 10 minutes.
+* `update` - Default is 10 minutes.
+* `delete` - Default is 30 minutes.
+
+## Attribute Reference
+
+The following attributes are exported:
+
+- `id` (String) The ID of this resource.
+
+## Import
+
+In Terraform v1.7.0 and later, use an import block to import Channel. For example:
+
+```terraform
+import {
+  to = rmon_channel.example
+  id = "1"
+}
+```
+
+Using terraform import, import Channel can be imported using the `id`, e.g. For example:
+
+```shell
+% terraform import rmon_channel.example 1
+```

Diff for: docs/resources/group.md

@@ -10,9 +10,21 @@ description: |-
 
 Represent roxy-wi group. All servers managed via RMON can be included in groups. A group is a user-defined pool of servers. It is up to you decide how you will group your servers. You can create groups because of their type, purpose, etc. By default, all your servers are included in the common group named Default. All other groups are created within this group.
 
+## Example Usage
 
+```terraform
+provider "rmon" {
+  base_url = "https://..."
+  login    = "test"
+  password = "testpass"
+}
+
+resource "rmon_group" "example" {
+  name        = "example_group2"
+  description = "test terraform group2"
+}
+```
 
-<!-- schema generated by tfplugindocs -->
 ## Schema
 
 ### Required
@@ -29,10 +41,30 @@ Represent roxy-wi group. All servers managed via RMON can be included in groups.
 - `id` (String) The ID of this resource.
 
 <a id="nestedblock--timeouts"></a>
+
 ### Nested Schema for `timeouts`
 
+This resource supports the following timeouts:
+
 Optional:
 
-- `create` (String)
-- `delete` (String)
-- `update` (String)
+* `create` - Default is 10 minutes.
+* `update` - Default is 10 minutes.
+* `delete` - Default is 30 minutes.
+
+## Import
+
+In Terraform v1.7.0 and later, use an import block to import Group. For example:
+
+```terraform
+import {
+  to = rmon_group.example
+  id = "1"
+}
+```
+
+Using terraform import, import Group can be imported using the `id`, e.g. For example:
+
+```shell
+% terraform import rmon_group.example 1
+```