clear rst from md in consumer & broker reference docs

Author: Sattar Gyulmamedov

mddocs/docs/en/reference/broker/index.md

@@ -1,8 +1,6 @@
-(message-broker)=
+# Message Broker { #message-broker }
 
-# Message Broker
-
-Message broker is component used by OpenLineage to store all received events. Then these avents are handled by {ref}`message-consumer`, in batches.
+Message broker is component used by OpenLineage to store all received events. Then these avents are handled by [`message-consumer`][message-consumer], in batches.
 
 Currently, Data.Rentgen supports only [Apache Kafka](https://kafka.apache.org/) as message broker.
 
@@ -13,7 +11,7 @@ Other popular OpenLineage server implementations use HTTP protocol for receiving
 - Kafka is designed to be scalable. If performance level is not enough, just add another broker to the cluster. For HTTP servers it's not that simple,
   as this requires load balancing on reverse proxy side or DNS side.
 - Kafka is designed to receive A LOT of events per second, like millions, and store them on disk as fast as possible. So no events are lost
-  even if {ref}`message-consumer` is overloaded - events are already on disk, and will be handled later.
+  even if [`message-consumer`][message-consumer] is overloaded - events are already on disk, and will be handled later.
 - ETL scripts are mostly run on schedule The usual pattern is almost zero events during the day, but huge spikes at every whole hour
   (e.g. at 00:00, 01:00, 03:00, 12:00). Kafka is used as an intermediate buffer which smooths these spikes.
 - Events stored in Kafka can be read in batches, even if OpenLineage integration initially send them one-by-one.
@@ -38,23 +36,24 @@ Other popular OpenLineage server implementations use HTTP protocol for receiving
 
   ```console
   $ docker compose --profile broker up -d --wait
+  ...
   ```
 
   `docker-compose` will download Apache Kafka image, create container and volume, and then start container.
 
   Image entrypoint will create database if volume is empty.
   Options can be set via `.env` file or `environment` section in `docker-compose.yml`
 
-  ```{eval-rst}
-  .. dropdown:: ``docker-compose.yml``
+=== "docker-compose.yml"
 
+  ```yaml
     .. literalinclude:: ../../../docker-compose.yml
         :emphasize-lines: 101-117,177
   ```
 
-  ```{eval-rst}
-  .. dropdown:: ``.env.docker``
+=== ".env.docker"
 
+  ```yaml
     .. literalinclude:: ../../../.env.docker
         :emphasize-lines: 7-20
   ```

mddocs/docs/en/reference/consumer/configuration/consumer-specific.md

@@ -1,7 +1,3 @@
-(configuration-consumer-specific)=
+# Consumer-specific settings { #configuration-consumer-specific }
 
-# Consumer-specific settings
-
-```{eval-rst}
-.. autopydantic_model:: data_rentgen.consumer.settings.consumer.ConsumerSettings
-```
+::: data_rentgen.consumer.settings.consumer.ConsumerSettings

mddocs/docs/en/reference/consumer/configuration/index.md

@@ -1,18 +1,3 @@
-(configuration-consumer)=
+# Consumer configuration { #configuration-consumer }
 
-# Consumer configuration
-
-```{toctree}
-:caption: Configuration
-:hidden: true
-:maxdepth: 1
-
-kafka
-consumer-specific
-producer-specific
-logging
-```
-
-```{eval-rst}
-.. autopydantic_settings:: data_rentgen.consumer.settings.ConsumerApplicationSettings
-```
+::: data_rentgen.consumer.settings.ConsumerApplicationSettings

mddocs/docs/en/reference/consumer/configuration/kafka.md

@@ -1,27 +1,13 @@
-(configuration-consumer-kafka)=
+# Kafka settings { #configuration-consumer-kafka }
 
-# Kafka settings
+::: data_rentgen.consumer.settings.kafka.KafkaSettings
 
-```{eval-rst}
-.. autopydantic_model:: data_rentgen.consumer.settings.kafka.KafkaSettings
-```
+::: data_rentgen.consumer.settings.security.scram.KafkaSecurityScram256Settings
 
-```{eval-rst}
-.. autopydantic_model:: data_rentgen.consumer.settings.security.scram.KafkaSecurityScram256Settings
-```
+::: data_rentgen.consumer.settings.security.scram.KafkaSecurityScram512Settings
 
-```{eval-rst}
-.. autopydantic_model:: data_rentgen.consumer.settings.security.scram.KafkaSecurityScram512Settings
-```
+::: data_rentgen.consumer.settings.security.plain.KafkaSecurityPlaintextSettings
 
-```{eval-rst}
-.. autopydantic_model:: data_rentgen.consumer.settings.security.plain.KafkaSecurityPlaintextSettings
-```
+::: data_rentgen.consumer.settings.security.gssapi.KafkaSecurityGSSAPISettings
 
-```{eval-rst}
-.. autopydantic_model:: data_rentgen.consumer.settings.security.gssapi.KafkaSecurityGSSAPISettings
-```
-
-```{eval-rst}
-.. autopydantic_model:: data_rentgen.consumer.settings.security.anonymous.KafkaSecurityAnonymousSettings
-```
+::: data_rentgen.consumer.settings.security.anonymous.KafkaSecurityAnonymousSettings

mddocs/docs/en/reference/consumer/configuration/logging.md

@@ -1,7 +1,3 @@
-(configuration-consumer-logging)=
+# Logging settings { #configuration-consumer-logging }
 
-# Logging settings
-
-```{eval-rst}
-.. autopydantic_model:: data_rentgen.logging.settings.LoggingSettings
-```
+::: data_rentgen.logging.settings.LoggingSettings

mddocs/docs/en/reference/consumer/configuration/producer-specific.md

@@ -1,7 +1,3 @@
-(configuration-producer-specific)=
+# Producer-specific settings { #configuration-producer-specific }
 
-# Producer-specific settings
-
-```{eval-rst}
-.. autopydantic_model:: data_rentgen.consumer.settings.producer.ProducerSettings
-```
+::: data_rentgen.consumer.settings.producer.ProducerSettings

mddocs/docs/en/reference/consumer/index.md

@@ -1,9 +1,6 @@
-(message-consumer)=
+# Message Consumer { #message-consumer }
 
-# Message Consumer
-
-Data.Rentgen fetches messages from a {ref}`message-broker` using a [FastStream](https://faststream.airt.ai) based consumer, parses incoming messages,
-and creates all parsed entities in the {ref}`database`. Malformed messages are send back to broker, to different topic.
+Data.Rentgen fetches messages from a [`message-broker`][message-broker] using a [FastStream](https://faststream.airt.ai) based consumer, parses incoming messages, and creates all parsed entities in the [`database`][database]. Malformed messages are send back to broker, to different topic.
 
 ## Install & run
 
@@ -17,22 +14,23 @@ and creates all parsed entities in the {ref}`database`. Malformed messages are s
 
   ```console
   $ docker compose --profile consumer up -d --wait
+  ...
   ```
 
   `docker-compose` will download all necessary images, create containers, and then start consumer process.
 
   Options can be set via `.env` file or `environment` section in `docker-compose.yml`
 
-  ```{eval-rst}
-  .. dropdown:: ``docker-compose.yml``
+=== "docker-compose.yml"
 
+  ```yaml
     .. literalinclude:: ../../../docker-compose.yml
         :emphasize-lines: 120-138
   ```
 
-  ```{eval-rst}
-  .. dropdown:: ``.env.docker``
+=== ".env.docker"
 
+  ```yaml
     .. literalinclude:: ../../../.env.docker
         :emphasize-lines: 22-24,29-34
   ```
@@ -41,48 +39,51 @@ and creates all parsed entities in the {ref}`database`. Malformed messages are s
 
 - Install Python 3.10 or above
 
-- Setup {ref}`database`, run migrations and create partitions
+- Setup [`database`][database], run migrations and create partitions
 
-- Setup {ref}`message-broker`
+- Setup [`message-broker`][message-broker]
 
 - Create virtual environment
 
   ```console
   $ python -m venv /some/.venv
+  ...
   $ source /some/.venv/activate
+  ...
   ```
 
 - Install `data-rentgen` package with following *extra* dependencies:
 
   ```console
   $ pip install data-rentgen[consumer,postgres]
+  ...
   ```
 
-  :::{note}
+!!! note
+
   For `SASL_GSSAPI` auth mechanism you also need to install system packages providing `kinit` and `kdestroy` binaries:
 
   ```console
   $ apt install libkrb5-dev krb5-user gcc make autoconf  # Debian-based
+  ...
   $ dnf install krb5-devel krb5-libs krb5-workstation gcc make autoconf  # CentOS, OracleLinux
+  ...
   ```
 
   And then install `gssapi` extra:
 
   ```console
   $ pip install data-rentgen[consumer,postgres,gssapi]
+  ...
   ```
-  :::
 
 - Run consumer process
 
   ```console
   $ python -m data_rentgen.consumer
+  ...
   ```
 
 ## See also
 
-```{toctree}
-:maxdepth: 1
-
-configuration/index
-```
+[Consumer configuration][configuration/index.md]