diff --git a/docs/index.md b/docs/index.md
index b55d186..25585a5 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -26,13 +26,10 @@ provider "sys11dbaas" {
 <!-- schema generated by tfplugindocs -->
 ## Schema
 
-### Required
+### Optional
 
 - `api_key` (String) API key to use for authentication to the DBaaS API. If omitted, the `SYS11DBAAS_API_KEY` environment variable is used.
 - `organization` (String) ID of your organization. If omitted, the `SYS11DBAAS_ORGANIZATION` environment variable is used.
 - `project` (String) ID of your project. If omitted, the `SYS11DBAAS_PROJECT` environment variable is used.
-
-### Optional
-
 - `url` (String) URL of the DBaaS API. If omitted, the `SYS11DBAAS_URL` environment variable is used. Otherwise fallbacks to https://dbaas.apis.syseleven.de
 - `wait_for_creation` (Boolean) Whether to wait for the service to be created. If omitted, the `SYS11DBAAS_WAIT_FOR_CREATION` environment variable is used. Defaults to true
diff --git a/docs/resources/database.md b/docs/resources/database.md
index f30ba4e..671f15a 100644
--- a/docs/resources/database.md
+++ b/docs/resources/database.md
@@ -110,14 +110,14 @@ Optional:
 
 Required:
 
-- `disksize` (Number) Disksize in GB
-- `flavor` (String) vm flavor to use
-- `region` (String) the region for the database
+- `disksize` (Number) Disksize in GB.
+- `flavor` (String) VM flavor to use.
+- `region` (String) Region for the database.
 
 Optional:
 
-- `maintenance_window` (Attributes) The maintenance window. This will be a time window for updates and maintenance. If omitted, a random window will be generated. (see [below for nested schema](#nestedatt--service_config--maintenance_window))
-- `remote_ips` (List of String) List of IP addresses, that should be allowed to connect to the database
+- `maintenance_window` (Attributes) Maintenance window. This will be a time window for updates and maintenance. If omitted, a random window will be generated. (see [below for nested schema](#nestedatt--service_config--maintenance_window))
+- `remote_ips` (List of String) List of IP addresses, that should be allowed to connect to the database.
 - `type` (String) Type of the service you want to create (default `database`)
 
 <a id="nestedatt--service_config--maintenance_window"></a>