further improvements

Author: Blargian

.gitignore

@@ -62,3 +62,4 @@ ClickHouse/
 # Ignore table of contents files
 docs/cloud/reference/release-notes-index.md
 docs/whats-new/changelog/index.md
+docs/cloud/manage/api/api-reference-index.md

contribute/style-guide.md

@@ -1,12 +1,12 @@
 # ClickHouse docs style guide
 
-In this document, you will find a number of style guidelines for writing documentation.
-The rules in this guide are intended to assist in helping us to create a high
-quality documentation offering on par with the quality of ClickHouse itself.
+In this document, you will find a number of style guidelines for writing ClickHouse
+documentation. As documentation is a collective effort, these guidelines are 
+intended to help all of us ensure quality and consistency across our documentation.
 
 ## YAML front matter
 
-Begin every new markdown document with YAML front-matter:
+Begin every new Markdown document with YAML front-matter:
 
 ```markdown
 ---

docs/cloud/manage/api/api-reference-index.md

@@ -4,11 +4,7 @@ slug: /cloud/manage/api/
 description: 'Landing page for Cloud API'
 ---
 
-| Page                                                           | Description                      |
-|----------------------------------------------------------------|----------------------------------|
-| [Invitations](/cloud/manage/api/invitations-api-reference)     | API reference for invitations.   |
-| [Keys](/cloud/manage/api/keys-api-reference)                   | API reference for keys.          |
-| [Members](/cloud/manage/api/members-api-reference)             | API reference for requests.      |
-| [Organizations](/cloud/manage/api/organizations-api-reference) | API reference for organizations. |
-| [Services](/cloud/manage/api/services-api-reference)           | API reference for services.      |
-| [Usage cost](/cloud/manage/api/usageCost-api-reference)        | API reference for services.      |
+<!-- The table on this page is autogenerated by the script at https://github.com/ClickHouse/clickhouse-docs/blob/main/scripts/autogenerate-table-of-contents.sh
+if you've spotted an error or want to change something, please edit the YAML
+frontmatter of the files themselves.
+-->

docs/cloud/manage/api/index.md

@@ -10,4 +10,4 @@ This section contains reference documentation for Cloud API and contains the fol
 |---------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
 | [Overview](/cloud/manage/api/api-overview)|  Provides an overview of rate limits, Terraform Provider, Swagger (OpenAPI) Endpoint and UI and available support.                   | 
 | [Managing API Keys](/cloud/manage/openapi)                          | Learn more about Cloud's API utilizing OpenAPI that allows you to programmatically manage your account and aspects of your services. |
-| [API Reference](/cloud/manage/api)                              | API reference documentation.                                                                                                         |
+| [API Reference](/cloud/manage/api)                              | API reference documentation.                                                                                                         |