diff --git a/src/components/HelpMark/README.md b/src/components/HelpMark/README.md
index ceaca18585..a94212dd82 100644
--- a/src/components/HelpMark/README.md
+++ b/src/components/HelpMark/README.md
@@ -8,11 +8,10 @@
 import {HelpMark} from '@gravity-ui/uikit';
 ```
 
-Component to display help icon with popover
+A help icon that reveals contextual information in a popover on hover or click. Ideal for showing tips, explanations, or supporting content without taking up extra space in the interface.
 
 ## Examples
 
-Component with rendered raw html and close on mouse leave:
 
 <!--LANDING_BLOCK
 
@@ -56,7 +55,8 @@ LANDING_BLOCK-->
 
 `HelpMark` accepts any valid `button` element props in addition to these:
 
-| Name         | Description              |           Type           | Default |
-| :----------- | :----------------------- | :----------------------: | :-----: |
-| iconSize     | Sets icon size           | `"s"` `"m"` `"l"` `"xl"` |  `"m"`  |
-| popoverProps | Override `Popover` props |      `PopoverProps`      |         |
+| Name         | Description                         |           Type           | Default |
+| :----------- | :---------------------------------  | :----------------------: | :-----: |
+| iconSize     | Sets icon size                      | `"s"` `"m"` `"l"` `"xl"` |  `"m"`  |
+| popoverProps | Override `Popover` props            |      `PopoverProps`      |         |
+| children     | Content displayed inside the popover | `React.ReactNode`        |         |