Improve migration guide location (#94)

* Improve migration guide location to proper location

* Improve migration guide

* Improve provider documentation

* Improve provider documentation

* Improve provider documentation

Author: sahaqaa

README.md

@@ -19,6 +19,10 @@
 
 The Terraform provider for [CloudConnexa](https://openvpn.net/cloud-vpn/?utm_source=terraform&utm_medium=docs) allows teams to configure and update CloudConnexa project parameters via their command line.
 
+## Guides
+
+- [Migration from v0.X.X to v1.0.0](https://registry.terraform.io/providers/OpenVPN/cloudconnexa/latest/docs/guides/migration-to-v1)
+
 ## Maintainers
 
 This provider plugin is maintained by:

MIGRATION-TO-APIv1.md docs/guides/migration-to-v1.mdMIGRATION-TO-APIv1.md renamed to docs/guides/migration-to-v1.md

@@ -1,8 +1,13 @@
-# Terraform v1.0.0 migration guide
+---
+page_title: "Upgrading to version 1 (from 0.x)"
+description: Terraform CloudConnexa Provider Version 1 Upgrade Guide
+---
 
-Important: this migration guide is created to outline migration from older versions of Terraform provider (which where using "/beta" endpoint) to Terraform provider v1.0.0 (which is using "/v1" endpoint).
+# Terraform CloudConnexa Provider Version 1 Upgrade Guide
 
-In v1.0.0 we intruduced BREAKING CHANGES, which we will cover in this migration guide.
+This migration guide is created to outline migration from older versions of Terraform provider (which where using "/beta" endpoint) to Terraform provider v1.0.0 (which is using "/v1" endpoint).
+
+Version 1 of the CloudConnexa Terraform Provider is introducing several BREAKING CHANGES, which we will cover in this migration guide.
 
 ## 1/ Data sources will use only "id" field
 

docs/index.md

@@ -1,16 +1,53 @@
 ---
-# generated by https://github.com/hashicorp/terraform-plugin-docs
 page_title: "cloudconnexa Provider"
 subcategory: ""
 description: |-
-  
+  The CloudConnexa provider provides resources to interact with the CloudConnexa API.
 ---
 
 # cloudconnexa Provider
 
+Use this provider to interact with the [CloudConnexa API](https://openvpn.net/cloud-docs/developer/index.html).
+The provider needs to be configured with the proper credentials before it can be used.
 
+## Credentials
 
+To authenticate with the CloudConnexa API, you'll need the client_id and client_secret.
+These credentials can be found in the CloudConnexa Portal.
 
+Go to the Settings page and click on the API tab.
+From there, you can enable the API and generate new authentication credentials.
+Additionally, you'll find Swagger documentation for the API in the same location.
+
+More documentation on the CloudConnexa API credentials can be found here:
+[Creating API credentials](https://openvpn.net/cloud-docs/developer/creating-api-credentials.html)
+
+!> **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.
+
+## Example Usage
+
+```terraform
+terraform {
+  required_providers {
+    cloudconnexa = {
+      source  = "OpenVPN/cloudconnexa"
+      version = "~> 1"
+    }
+  }
+}
+
+provider "cloudconnexa" {
+  client_id     = var.cloudconnexa_client_id
+  client_secret = var.cloudconnexa_client_secret
+}
+
+# Create a User Group
+resource "cloudconnexa_user_group" "this" {
+  # ...
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

examples/provider/provider.tf

@@ -0,0 +1,18 @@
+terraform {
+  required_providers {
+    cloudconnexa = {
+      source  = "OpenVPN/cloudconnexa"
+      version = "~> 1"
+    }
+  }
+}
+
+provider "cloudconnexa" {
+  client_id     = var.cloudconnexa_client_id
+  client_secret = var.cloudconnexa_client_secret
+}
+
+# Create a User Group
+resource "cloudconnexa_user_group" "this" {
+  # ...
+}