From 163f4c2199983f719aed3b859534b58548b57800 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Thu, 4 Jul 2024 18:48:59 +0200
Subject: [PATCH] Better docs

---
 .../data-types/data-types-binary-encoding.md           | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/en/sql-reference/data-types/data-types-binary-encoding.md b/docs/en/sql-reference/data-types/data-types-binary-encoding.md
index d7eddf848d6..c9720da0f1c 100644
--- a/docs/en/sql-reference/data-types/data-types-binary-encoding.md
+++ b/docs/en/sql-reference/data-types/data-types-binary-encoding.md
@@ -7,6 +7,11 @@ sidebar_label: Data types binary encoding specification.
 
 # Data types binary encoding specification
 
+This specification describes the binary format that can be used for binary encoding and decoding of ClickHouse data types. This format is used in `Dynamic` column [binary serialization](dynamic.md#binary-output-format) and can be used in input/output formats [RowBinaryWithNamesAndTypes](../../interfaces/formats.md#rowbinarywithnamesandtypes) and [Native](../../interfaces/formats.md#native) under corresponding settings.
+
+The table below describes how each data type is represented in bunary format. Each data type encoding consist of 1 byte that indicates the type and some optional additional information.
+`var_uint` in the binary encoding means that the size is encoded using Variable-Length Quantity compression.
+
 | ClickHouse data type                                                                 | Binary encoding                                                                                                                                                                                                                                                                                                        |
 |--------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | `Nothing`                                                                            | `0x00`                                                                                                                                                                                                                                                                                                                 |
@@ -61,6 +66,8 @@ sidebar_label: Data types binary encoding specification.
 
 ### Interval kind binary encoding
 
+The table below describes how different interval kinds of `Interval` data type are endoced.
+
 | Interval kind | Binary encoding |
 |---------------|-----------------|
 | `Nanosecond`  | `0x00`          |
@@ -77,6 +84,9 @@ sidebar_label: Data types binary encoding specification.
 
 ### Aggregate function parameter binary encoding
 
+The table below describes how parameters of `AggragateFunction` and `SimpleAggregateFunction` are encoded.
+The encoding of a parameter consists of 1 byte indicating the type of the parameter and the value itself.
+
 | Parameter type           | Binary encoding                                                                                                                |
 |--------------------------|--------------------------------------------------------------------------------------------------------------------------------|
 | `Null`                   | `0x00`                                                                                                                         |