[docs] enable yfmlint and fix some syntax issues it finds (#8427)

Author: blinkov

ydb/docs/.yfmlint

@@ -1,2 +1,67 @@
 log-levels:
-  YFM001: 'disabled'
+  MD001: 'error' # Heading levels should only increment by one level at a time
+  MD002: 'error' # First heading should be a top-level heading
+  MD003: 'disabled' # Heading style
+  MD004: 'disabled' # Unordered list style
+  MD005: 'error' # Inconsistent indentation for list items at the same level
+  MD006: 'error' # Consider starting bulleted lists at the beginning of the line
+  MD007: 'error' # Unordered list indentation
+  MD009: 'error' # Trailing spaces
+  MD010: 'error' # Hard tabs
+  MD011: 'error' # Reversed link syntax
+  MD012: 'disabled' # Multiple consecutive blank lines
+  MD013: 'disabled' # Line length
+  MD014: 'disabled' # Dollar signs used before commands without showing output
+  MD018: 'disabled' # No space after hash on atx style heading
+  MD019: 'disabled' # Multiple spaces after hash on atx style heading
+  MD020: 'disabled' # No space inside hashes on closed atx style heading
+  MD021: 'disabled' # Multiple spaces inside hashes on closed atx style heading
+  MD022: 'disabled' # Headings should be surrounded by blank lines
+  MD023: 'disabled' # Headings must start at the beginning of the line
+  MD024: 'disabled' # Multiple headings with the same content
+  MD025: 'error' # Multiple top-level headings in the same document
+  MD026: 'disabled' # Trailing punctuation in heading
+  MD027: 'disabled' # Multiple spaces after blockquote symbol
+  MD028: 'disabled' # Blank line inside blockquote
+  MD029: 'disabled' # Ordered list item prefix
+  MD030: 'disabled' # Spaces after list markers
+  MD031: 'disabled' # Fenced code blocks should be surrounded by blank lines
+  MD032: 'disabled' # Lists should be surrounded by blank lines
+  MD033: 'disabled' # Inline HTML
+  MD034: 'disabled' # Bare URL used
+  MD035: 'disabled' # Horizontal rule style
+  MD036: 'disabled' # Emphasis used instead of a heading
+  MD037: 'error' # Spaces inside emphasis markers
+  MD038: 'error' # Spaces inside code span elements
+  MD039: 'error' # Spaces inside link text
+  MD040: 'disabled' # Fenced code blocks should have a language specified
+  MD041: 'disabled' # First line in a file should be a top-level heading
+  MD042: 'error' # No empty links
+  MD043: 'disabled' # Required heading structure
+  MD044: 'disabled' # Proper names should have the correct capitalization
+  MD045: 'disabled' # Images should have alternate text (alt text)
+  MD046: 'disabled' # Code block style
+  MD047: 'disabled' # Files should end with a single newline character
+  MD048: 'disabled' # Code fence style
+  MD049: 'disabled' # Emphasis style should be consistent
+  MD050: 'disabled' # Strong style should be consistent
+  MD051: 'error' # Link fragments should be valid
+  MD052: 'error' # Reference links and images should use a label that is defined
+  MD053: 'error' # Link and image reference definitions should be needed
+  MD054: 'error' # Link and image style
+  MD055: 'error' # Table pipe style
+  MD056: 'error' # Table column count
+
+  YFM001: 'error' # Inline code length
+  YFM002: 'error' # No header found in the file for the link text
+  YFM003: 'error' # Link is unreachable
+  YFM004: 'error' # Table not closed
+  YFM005: 'error' # Tab list not closed
+  YFM006: 'error' # Term definition duplicated
+  YFM007: 'error' # Term used without definition
+  YFM008: 'error' # Term inside definition not allowed
+  YFM009: 'error' # Term definition used not at the end of file
+
+# Inline code length
+YFM001:
+  maximum: 140

ydb/docs/en/core/_includes/alerts/no-translation.md

@@ -1,5 +1,5 @@
 {% note info %}
 
-This а article is currently in development and will soon be available on the website. 
+This а article is currently in development and will soon be available on the website.
 
 {% endnote %}

ydb/docs/en/core/changelog-cli.md

@@ -12,14 +12,16 @@ Released on June 24, 2024. To update to version **2.10.0**, select the [Download
 * Added replication description support in the `ydb scheme describe` and `ydb scheme ls` commands.
 * Added big datetime types support: `Date32`, `Datetime64`, `Timestamp64`, `Interval64`.
 * `ydb workload` commands rework:
-   * Added the `--clear` option to the `init` subcommand, allowing tables from previous runs to be removed before workload initialization.
-   * Added the `ydb workload * import` command to prepopulate tables with initial content before executing benchmarks.
+
+  * Added the `--clear` option to the `init` subcommand, allowing tables from previous runs to be removed before workload initialization.
+  * Added the `ydb workload * import` command to prepopulate tables with initial content before executing benchmarks.
 
 **Backward incompatible changes:**
 
 * `ydb workload` commands rework:
-   * The `--path` option was moved to a specific workload level. For example: `ydb workload tpch --path some/tables/path init ...`.
-   * The `--store=s3` option was changed to `--store=external-s3` in the `init` subcommand.
+
+  * The `--path` option was moved to a specific workload level. For example: `ydb workload tpch --path some/tables/path init ...`.
+  * The `--store=s3` option was changed to `--store=external-s3` in the `init` subcommand.
 
 
 **Bug fixes:**
@@ -33,7 +35,7 @@ Released on April 25, 2024. To update to version **2.9.0**, select the [Download
 **Features:**
 
 * Improved query logical plan tables: added colors, more information, fixed some bugs.
-* The verbose option `-v`` is supported for `ydb workload` commands to provide debug information.
+* The verbose option `-v` is supported for `ydb workload` commands to provide debug information.
 * Added an option to run `ydb workload tpch` with an S3 source to measure [federated queries](concepts/federated_query/index.md) performance.
 * Added the `--rate` option for `ydb workload` commands to control the transactions (or requests) per second limit.
 * Added the `--use-virtual-addressing` option for S3 import/export, allowing the switch to [virtual hosting of buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html) for the S3 path layout.
@@ -246,16 +248,18 @@ Release date: September 20, 2022. To update to version **2.0.0**, select the [Do
 **Features:**
 
 * Added the ability to work with topics:
-   * `ydb topic create`: Create a topic.
-   * `ydb topic alter`: Update a topic.
-   * `ydb topic write`: Write data to a topic.
-   * `ydb topic read`: Read data from a topic.
-   * `ydb topic drop`: Delete a topic.
+
+  * `ydb topic create`: Create a topic.
+  * `ydb topic alter`: Update a topic.
+  * `ydb topic write`: Write data to a topic.
+  * `ydb topic read`: Read data from a topic.
+  * `ydb topic drop`: Delete a topic.
 
 * Added a new type of load testing:
-   * `ydb workload kv init`: Create a table for kv load testing.
-   * `ydb workload kv run`: Apply one of three types of load: run multiple `UPSERT` sessions, run multiple `INSERT` sessions, or run multiple sessions of GET requests by primary key.
-   * `ydb workload kv clean`: Delete a test table.
+
+  * `ydb workload kv init`: Create a table for kv load testing.
+  * `ydb workload kv run`: Apply one of three types of load: run multiple `UPSERT` sessions, run multiple `INSERT` sessions, or run multiple sessions of GET requests by primary key.
+  * `ydb workload kv clean`: Delete a test table.
 
 * Added the ability to disable current active profile (see the `ydb config profile deactivate` command).
 * Added the ability to delete a profile non-interactively with no commit (see the `--force` option under the `ydb config profile remove` command).

ydb/docs/en/core/changelog-server.md

@@ -219,32 +219,37 @@ Release date: October 12, 2022. To update to version **22.4**, select the [Downl
 **What's new:**
 
 * {{ ydb-short-name }} Topics and Change Data Capture (CDC):
-   * Introduced the new Topic API. {{ ydb-short-name }} [Topic](concepts/topic.md) is an entity for storing unstructured messages and delivering them to various subscribers.
-   * Added support for the Topic API to the [{{ ydb-short-name }} CLI](reference/ydb-cli/topic-overview.md) and [SDK](reference/ydb-sdk/topic.md). The Topic API provides methods for message streaming writes and reads as well as topic management.
-   * Added the ability to [capture table updates](concepts/cdc.md) and send change messages to a topic.
+
+  * Introduced the new Topic API. {{ ydb-short-name }} [Topic](concepts/topic.md) is an entity for storing unstructured messages and delivering them to various subscribers.
+  * Added support for the Topic API to the [{{ ydb-short-name }} CLI](reference/ydb-cli/topic-overview.md) and [SDK](reference/ydb-sdk/topic.md). The Topic API provides methods for message streaming writes and reads as well as topic management.
+  * Added the ability to [capture table updates](concepts/cdc.md) and send change messages to a topic.
 
 * SDK:
-   * Added the ability to handle topics in the {{ ydb-short-name }} SDK.
-   * Added official support for the database/sql driver for working with {{ ydb-short-name }} in Golang.
+
+  * Added the ability to handle topics in the {{ ydb-short-name }} SDK.
+  * Added official support for the database/sql driver for working with {{ ydb-short-name }} in Golang.
 
 * Embedded UI:
-   * The CDC changefeed and the secondary indexes are now displayed in the database schema hierarchy as separate objects.
-   * Improved the visualization of query explain plan graphics.
-   * Problem storage groups have more visibility now.
-   * Various improvements based on UX research.
+
+  * The CDC changefeed and the secondary indexes are now displayed in the database schema hierarchy as separate objects.
+  * Improved the visualization of query explain plan graphics.
+  * Problem storage groups have more visibility now.
+  * Various improvements based on UX research.
 
 * Query Processing:
-   * Added Query Processor 2.0, a new subsystem to execute OLTP queries with significant improvements compared to the previous version.
-   * Improved write performance by up to 60%, and by up to 10% for reads.
-   * Added the ability to include a NOT NULL restriction for YDB primary keys when creating tables.
-   * Added support for renaming a secondary index online without shutting the service down.
-   * Improved the query explain view that now also includes fields for the physical operators.
+
+  * Added Query Processor 2.0, a new subsystem to execute OLTP queries with significant improvements compared to the previous version.
+  * Improved write performance by up to 60%, and by up to 10% for reads.
+  * Added the ability to include a NOT NULL restriction for YDB primary keys when creating tables.
+  * Added support for renaming a secondary index online without shutting the service down.
+  * Improved the query explain view that now also includes fields for the physical operators.
 
 * Core:
-   * For read only transactions, added consistent snapshot support that does not conflict with write transactions.
-   * Added BulkUpsert support for tables with asynchronous secondary indexes.
-   * Added TTL support for tables with asynchronous secondary indexes.
-   * Added compression support for data export to S3.
-   * Added an audit log for DDL statements.
-   * Added support for authentication with static credentials.
-   * Added system tables for query performance troubleshooting.
+
+  * For read only transactions, added consistent snapshot support that does not conflict with write transactions.
+  * Added BulkUpsert support for tables with asynchronous secondary indexes.
+  * Added TTL support for tables with asynchronous secondary indexes.
+  * Added compression support for data export to S3.
+  * Added an audit log for DDL statements.
+  * Added support for authentication with static credentials.
+  * Added system tables for query performance troubleshooting.

ydb/docs/en/core/concepts/_includes/index/intro.md

@@ -1,8 +1,3 @@
----
-title: "YDB. DBMS overview"
-description: "YDB is a horizontally scalable distributed fault-tolerant DBMS. YDB is designed to meet high performance requirements, for example, a typical server can handle dozens of thousands of requests per second. The system is designed to handle hundreds of petabytes of data."
----
-
 # {{ ydb-short-name }} overview
 
 *{{ ydb-short-name }}* is a horizontally scalable distributed fault-tolerant DBMS. {{ ydb-short-name }} is designed for high performance with a typical server being capable of handling tens of thousands of queries per second. The system is designed to handle hundreds of petabytes of data. {{ ydb-short-name }} can operate in single data center and geo-distributed (cross data center) modes on a cluster of thousands of servers.