diff --git a/docs/data-sources/core_locations.md b/docs/data-sources/core_locations.md
index 8ad8faa4..60b190a3 100644
--- a/docs/data-sources/core_locations.md
+++ b/docs/data-sources/core_locations.md
@@ -37,12 +37,12 @@ data "anxcloud_core_locations" "example" {
 
 Read-Only:
 
-- `city_code` (String)
-- `code` (String)
-- `country` (String)
-- `identifier` (String)
-- `lat` (String)
-- `lon` (String)
-- `name` (String)
+- `city_code` (String) Location city code.
+- `code` (String) Location code.
+- `country` (String) Location country.
+- `identifier` (String) Identifier of the API resource.
+- `lat` (String) Location latitude.
+- `lon` (String) Location longitude.
+- `name` (String) Location name.
 
 
diff --git a/docs/data-sources/cpu_performance_types.md b/docs/data-sources/cpu_performance_types.md
index dd499f2e..3c7b8d3a 100644
--- a/docs/data-sources/cpu_performance_types.md
+++ b/docs/data-sources/cpu_performance_types.md
@@ -32,9 +32,9 @@ data "anxcloud_cpu_performance_types" "example" {}
 
 Read-Only:
 
-- `id` (String)
-- `limit` (Number)
-- `prioritization` (String)
-- `unit` (String)
+- `id` (String) CPU performance type identifier.
+- `limit` (Number) CPU performance type limit.
+- `prioritization` (String) CPU performance type prioritization.
+- `unit` (String) CPU performance type limit unit.
 
 
diff --git a/docs/data-sources/disk_types.md b/docs/data-sources/disk_types.md
index 42d2f736..c4daab7c 100644
--- a/docs/data-sources/disk_types.md
+++ b/docs/data-sources/disk_types.md
@@ -42,10 +42,10 @@ data "anxcloud_disk_types" "example" {
 
 Read-Only:
 
-- `bandwidth` (Number)
-- `id` (String)
-- `iops` (Number)
-- `latency` (Number)
-- `storage_type` (String)
+- `bandwidth` (Number) Bandwidth.
+- `id` (String) Identifier of the API resource.
+- `iops` (Number) Input/output operations per second.
+- `latency` (Number) Latency.
+- `storage_type` (String) Storage type.
 
 
diff --git a/docs/data-sources/dns_records.md b/docs/data-sources/dns_records.md
index 485ada81..5e6504a0 100644
--- a/docs/data-sources/dns_records.md
+++ b/docs/data-sources/dns_records.md
@@ -38,13 +38,13 @@ data "anxcloud_dns_records" "example" {
 
 Read-Only:
 
-- `identifier` (String)
-- `immutable` (Boolean)
-- `name` (String)
-- `rdata` (String)
-- `region` (String)
-- `ttl` (Number)
-- `type` (String)
-- `zone_name` (String)
+- `identifier` (String) DNS Record identifier. Changes on revision change and therefore shouldn't be used as reference.
+- `immutable` (Boolean) Specifies whether or not a record is immutable.
+- `name` (String) DNS record name.
+- `rdata` (String) DNS record data.
+- `region` (String) DNS record region (for GeoDNS aware records).
+- `ttl` (Number) Region specific TTL. If not set the zone TTL will be used.
+- `type` (String) DNS record type.
+- `zone_name` (String) Zone of DNS record.
 
 
diff --git a/docs/data-sources/dns_zones.md b/docs/data-sources/dns_zones.md
index 0855bedf..79fb0d0c 100644
--- a/docs/data-sources/dns_zones.md
+++ b/docs/data-sources/dns_zones.md
@@ -32,27 +32,27 @@ data "anxcloud_dns_zones" "example" {}
 
 Read-Only:
 
-- `admin_email` (String)
-- `deployment_level` (Number)
-- `dns_sec_mode` (String)
-- `dns_servers` (List of Object) (see [below for nested schema](#nestedobjatt--zones--dns_servers))
-- `expire` (Number)
-- `is_editable` (Boolean)
-- `is_master` (Boolean)
-- `master_nameserver` (String)
-- `name` (String)
-- `notify_allowed_ips` (List of String)
-- `refresh` (Number)
-- `retry` (Number)
-- `ttl` (Number)
-- `validation_level` (Number)
+- `admin_email` (String) Admin email address.
+- `deployment_level` (Number) Current deployment progress in percent.
+- `dns_sec_mode` (String) DNSSec mode value for master zones. [`managed` or `unvalidated`]
+- `dns_servers` (List of Object) (see [below for nested schema](#nestedobjatt--zones--dns_servers)) Configured DNS servers.
+- `expire` (Number) Expiration value.
+- `is_editable` (Boolean) Indicator if zone is editable.
+- `is_master` (Boolean) Indicator if the zone is a master zone.
+- `master_nameserver` (String) IP or domain of master nameserver.
+- `name` (String) Zone name.
+- `notify_allowed_ips` (List of String) IP addresses allowed to initiate domain transfer.
+- `refresh` (Number) Refresh value.
+- `retry` (Number) Retry value.
+- `ttl` (Number) TTL value.
+- `validation_level` (Number) Current validation level in percent.
 
 <a id="nestedobjatt--zones--dns_servers"></a>
 ### Nested Schema for `zones.dns_servers`
 
 Read-Only:
 
-- `alias` (String)
-- `server` (String)
+- `alias` (String) DNS server alias.
+- `server` (String) DNS server name.
 
 
diff --git a/docs/data-sources/ip_addresses.md b/docs/data-sources/ip_addresses.md
index 2c191725..1ef47272 100644
--- a/docs/data-sources/ip_addresses.md
+++ b/docs/data-sources/ip_addresses.md
@@ -37,9 +37,9 @@ data "anxcloud_ip_addresses" "example" {
 
 Read-Only:
 
-- `address` (String)
-- `description_customer` (String)
-- `identifier` (String)
-- `role` (String)
+- `address` (String) The IP address.
+- `description_customer` (String) Additional customer description.
+- `identifier` (String) Identifier of the API resource.
+- `role` (String) Role of the IP address.
 
 
diff --git a/docs/data-sources/tags.md b/docs/data-sources/tags.md
index 35ec09e8..3e89ec14 100644
--- a/docs/data-sources/tags.md
+++ b/docs/data-sources/tags.md
@@ -42,7 +42,7 @@ data "anxcloud_tags" "example" {
 
 Read-Only:
 
-- `identifier` (String)
-- `name` (String)
+- `identifier` (String) Identifier of the tag.
+- `name` (String) Name of the tag.
 
 
diff --git a/docs/data-sources/template.md b/docs/data-sources/template.md
index 5571835b..4118d455 100644
--- a/docs/data-sources/template.md
+++ b/docs/data-sources/template.md
@@ -63,22 +63,22 @@ Read-Only:
 
 Read-Only:
 
-- `boot_delay_seconds` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--boot_delay_seconds))
-- `cpus` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--cpus))
-- `disk_gb` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--disk_gb))
-- `disk_type` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--disk_type))
-- `dns0` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--dns0))
-- `dns1` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--dns1))
-- `dns2` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--dns2))
-- `dns3` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--dns3))
-- `enter_bios_setup` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--enter_bios_setup))
-- `hostname` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--hostname))
-- `ips` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--ips))
-- `memory_mb` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--memory_mb))
-- `nics` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--nics))
-- `password` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--password))
-- `user` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--user))
-- `vlan` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--vlan))
+- `boot_delay_seconds` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--boot_delay_seconds)) Boot delay parameter.
+- `cpus` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--cpus)) CPUs parameter.
+- `disk_gb` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--disk_gb)) Disk size parameter.
+- `disk_type` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--disk_type)) Disk type parameter.
+- `dns0` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--dns0)) DNS 0 parameter.
+- `dns1` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--dns1)) DNS 1 parameter.
+- `dns2` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--dns2)) DNS 2 parameter.
+- `dns3` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--dns3)) DNS 3 parameter.
+- `enter_bios_setup` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--enter_bios_setup)) Enter BIOS parameter.
+- `hostname` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--hostname)) Hostname parameter.
+- `ips` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--ips)) IPs parameter.
+- `memory_mb` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--memory_mb)) Memory parameter.
+- `nics` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--nics)) NICs parameter.
+- `password` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--password)) Password parameter.
+- `user` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--user)) User parameter.
+- `vlan` (List of Object) (see [below for nested schema](#nestedobjatt--templates--params--vlan)) VLAN parameter.
 
 <a id="nestedobjatt--templates--params--boot_delay_seconds"></a>
 ### Nested Schema for `templates.params.boot_delay_seconds`
diff --git a/docs/data-sources/vlans.md b/docs/data-sources/vlans.md
index 7c710d74..a9775706 100644
--- a/docs/data-sources/vlans.md
+++ b/docs/data-sources/vlans.md
@@ -37,8 +37,8 @@ data "anxcloud_vlans" "example" {
 
 Read-Only:
 
-- `description_customer` (String)
-- `identifier` (String)
-- `name` (String)
+- `description_customer` (String) Additional customer description.
+- `identifier` (String) Identifier of the API resource.
+- `name` (String) VLAN name.
 
 
diff --git a/docs/data-sources/vsphere_locations.md b/docs/data-sources/vsphere_locations.md
index 07fe909a..919938b3 100644
--- a/docs/data-sources/vsphere_locations.md
+++ b/docs/data-sources/vsphere_locations.md
@@ -8,6 +8,8 @@ description: |-
 
 # anxcloud_vsphere_locations (Data Source)
 
+~> This data-source is deprecated. Please use `anxcloud_core_locations` instead.
+
 Provides available vSphere locations.
 
 ## Example Usage
@@ -39,12 +41,12 @@ data "anxcloud_vsphere_locations" "example" {
 
 Read-Only:
 
-- `code` (String)
-- `country` (String)
-- `country_name` (String)
-- `identifier` (String)
-- `lat` (String)
-- `lon` (String)
-- `name` (String)
+- `code` (String) Location code.
+- `country` (String) Location country.
+- `country_name` (String) Location country name.
+- `identifier` (String) Identifier of the API resource.
+- `lat` (String) Location latitude.
+- `lon` (String) Location longitude.
+- `name` (String) Location name.
 
 
diff --git a/docs/index.md b/docs/index.md
index f7038680..e1ed2930 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -9,6 +9,10 @@ description: |-
 # anxcloud Provider
 
 
+-> Visit the [Anexia official website](https://anexia.com/en/) to get more info about Anexia Cloud.
+
+The `anxcloud` provider is used to interact with Anexia Cloud API.
+
 
 ## Example Usage
 
diff --git a/docs/resources/network_prefix.md b/docs/resources/network_prefix.md
index 8e9914e8..9e507e24 100644
--- a/docs/resources/network_prefix.md
+++ b/docs/resources/network_prefix.md
@@ -74,12 +74,10 @@ Optional:
 
 Read-Only:
 
-- `city_code` (String)
-- `code` (String)
-- `country` (String)
-- `identifier` (String)
-- `lat` (String)
-- `lon` (String)
-- `name` (String)
-
-
+- `city_code` (String) Location city code.
+- `code` (String) Location code.
+- `country` (String) Location country.
+- `identifier` (String) Identifier of the API resource.
+- `lat` (String) Location latitude.
+- `lon` (String) Location longitude.
+- `name` (String) Location name.
diff --git a/docs/resources/tag.md b/docs/resources/tag.md
index 6b2ec472..5e6f7e3e 100644
--- a/docs/resources/tag.md
+++ b/docs/resources/tag.md
@@ -52,20 +52,20 @@ Optional:
 
 Read-Only:
 
-- `customer` (List of Object) (see [below for nested schema](#nestedobjatt--organisation_assignments--customer))
-- `service` (List of Object) (see [below for nested schema](#nestedobjatt--organisation_assignments--service))
+- `customer` (List of Object) Customer related information. (see [below for nested schema](#nestedobjatt--organisation_assignments--customer))
+- `service` (List of Object) Service related information. (see [below for nested schema](#nestedobjatt--organisation_assignments--service))
 
 <a id="nestedobjatt--organisation_assignments--customer"></a>
 ### Nested Schema for `organisation_assignments.customer`
 
 Read-Only:
 
-- `customer_id` (String)
-- `demo` (Boolean)
-- `id` (String)
-- `name` (String)
-- `name_slug` (String)
-- `reseller` (String)
+- `customer_id` (String) Customer identifier.
+- `demo` (Boolean) Whether is demo.
+- `id` (String) Identifier.
+- `name` (String) Customer name.
+- `name_slug` (String) Slug name.
+- `reseller` (String) Reseller name.
 
 
 <a id="nestedobjatt--organisation_assignments--service"></a>
@@ -73,7 +73,7 @@ Read-Only:
 
 Read-Only:
 
-- `id` (String)
-- `name` (String)
+- `id` (String) Service identifier.
+- `name` (String) Service name.
 
 
diff --git a/docs/resources/virtual_server.md b/docs/resources/virtual_server.md
index e80b2963..9980ae4a 100644
--- a/docs/resources/virtual_server.md
+++ b/docs/resources/virtual_server.md
@@ -4,8 +4,6 @@ page_title: "anxcloud_virtual_server Resource - terraform-provider-anxcloud"
 subcategory: ""
 description: |-
   The virtual_server resource allows you to configure and run virtual machines.
-  Known limitations
-  removal of disks not supportedremoval of networks not supported
 ---
 
 # anxcloud_virtual_server (Resource)
@@ -161,36 +159,36 @@ Optional:
 
 Read-Only:
 
-- `cores` (Number)
-- `cpu` (Number)
-- `custom_name` (String)
-- `disks_info` (List of Object) (see [below for nested schema](#nestedobjatt--info--disks_info))
-- `disks_number` (Number)
-- `guest_os` (String)
-- `guest_tools_status` (String)
-- `identifier` (String)
-- `location_code` (String)
-- `location_country` (String)
-- `location_name` (String)
-- `name` (String)
-- `network` (List of Object) (see [below for nested schema](#nestedobjatt--info--network))
-- `ram` (Number)
-- `status` (String)
-- `version_tools` (String)
+- `cores` (Number) Number of CPU cores.
+- `cpu` (Number) Number of CPUs.
+- `custom_name` (String) Virtual server custom name.
+- `disks_info` (List of Object) Disks info. (see [below for nested schema](#nestedobjatt--info--disks_info))
+- `disks_number` (Number) Number of the attached disks.
+- `guest_os` (String) Guest operating system.
+- `guest_tools_status` (String) Guest tools status.
+- `identifier` (String) Identifier of the API resource.
+- `location_code` (String) Location code.
+- `location_country` (String) Location country.
+- `location_name` (String) Location name.
+- `name` (String) Virtual server name.
+- `network` (List of Object) Network interfaces. (see [below for nested schema](#nestedobjatt--info--network))
+- `ram` (Number) Memory in MB.
+- `status` (String) Virtual server status.
+- `version_tools` (String) Version tools.
 
 <a id="nestedobjatt--info--disks_info"></a>
 ### Nested Schema for `info.disks_info`
 
 Read-Only:
 
-- `bus_type` (String)
-- `bus_type_label` (String)
-- `disk_gb` (Number)
-- `disk_id` (Number)
-- `disk_type` (String)
-- `iops` (Number)
-- `latency` (Number)
-- `storage_type` (String)
+- `bus_type` (String) Bus type.
+- `bus_type_label` (String) Bus type label.
+- `disk_gb` (Number) Size of the disk in GB.
+- `disk_id` (Number) Disk identifier.
+- `disk_type` (String) Disk type.
+- `iops` (Number) Disk input/output operations per second.
+- `latency` (Number) Disk latency.
+- `storage_type` (String) Disk storage type.
 
 
 <a id="nestedobjatt--info--network"></a>
@@ -198,11 +196,11 @@ Read-Only:
 
 Read-Only:
 
-- `id` (Number)
-- `ip_v4` (List of String)
-- `ip_v6` (List of String)
-- `mac_address` (String)
-- `nic` (Number)
-- `vlan` (String)
+- `id` (Number) Network interface card identifier.
+- `ip_v4` (List of String) List of IPv4 addresses attached to the interface.
+- `ip_v6` (List of String) List of IPv6 addresses attached to the interface.
+- `mac_address` (String) MAC address of the NIC.
+- `nic` (Number) NIC type number.
+- `vlan` (String) VLAN identifier.
 
 
diff --git a/docs/resources/vlan.md b/docs/resources/vlan.md
index 1835be88..41b5779d 100644
--- a/docs/resources/vlan.md
+++ b/docs/resources/vlan.md
@@ -61,12 +61,10 @@ Optional:
 
 Read-Only:
 
-- `city_code` (String)
-- `code` (String)
-- `country` (String)
-- `identifier` (String)
-- `lat` (String)
-- `lon` (String)
-- `name` (String)
-
-
+- `city_code` (String) Location city code.
+- `code` (String) Location code.
+- `country` (String) Location country.
+- `identifier` (String) Identifier of the API resource.
+- `lat` (String) Location latitude.
+- `lon` (String) Location longitude.
+- `name` (String) Location name.