fix: fix after review

README.md

@@ -11,7 +11,7 @@
   <a href="https://npmjs.com/package/@vkontakte/vkui"><img src="https://img.shields.io/npm/v/@vkontakte/vkui/latest.svg?maxAge=3600" alt="open latest version"></a>
 </p>
 <p align="center">
-VKUI — это библиотека адаптивных React-компонентов, <br> для создания веб-приложений.<br>
+VKUI — это библиотека адаптивных React-компонентов<br> для создания веб-приложений.<br>
 Библиотека основана на <a href="https://www.figma.com/@vk">дизайн-системе ВКонтакте</a> и реализует её интерфейсы для различных платформ.<br>
 Релизы: <a href="https://github.com/VKCOM/VKUI/releases">https://github.com/VKCOM/VKUI/releases</a>.<br>
 Гайд по миграции <a href="https://vkcom.github.io/VKUI/#/Migration">на версию 5</a>.

packages/vkui/src/components/AdaptivityProvider/AdaptivityProvider.tsx

@@ -36,7 +36,7 @@ export const AdaptivityProvider = ({
   if (process.env.NODE_ENVIRONMENT === 'development') {
     // TODO [>=6]: удалить warn
     if (!LEGACY_disableInternalUseBridgeAdaptivity) {
-      warn("[@vkontakte/vk-bridge's deprecated] Если вы используете VK Bridge, то используйте хук `useAdaptivity()` из @vkontakte/vk-bridge-react и результат передайте в компонент (см. https://github.com/VKCOM/VKUI/issues/5049)"); // prettier-ignore
+      warn("[@vkontakte/vk-bridge] Интеграция VKUI с @vkontakte/vk-bridge устарела и будет удалена в v6. Используйте хук `useAdaptivity()` из @vkontakte/vk-bridge-react и результат передайте в компонент (см. https://github.com/VKCOM/VKUI/issues/5049)"); // prettier-ignore
     }
   }
 

packages/vkui/src/components/AppRoot/AppRoot.tsx

@@ -73,7 +73,7 @@ export const AppRoot = ({
   if (process.env.NODE_ENVIRONMENT === 'development') {
     if (!safeAreaInsets) {
       // TODO [>=6]: удалить warn
-      warn("[@vkontakte/vk-bridge's deprecated] Если вы используете VK Bridge, то используйте хук `useInsets()` из @vkontakte/vk-bridge-react и результат передайте в параметр `safeAreaInsets` (см. https://github.com/VKCOM/VKUI/issues/5049)"); // prettier-ignore
+      warn("[@vkontakte/vk-bridge] Интеграция VKUI с @vkontakte/vk-bridge устарела и будет удалена в v6. Используйте хук `useInsets()` из @vkontakte/vk-bridge-react и результат передайте в параметр `safeAreaInsets` (см. https://github.com/VKCOM/VKUI/issues/5049)"); // prettier-ignore
     }
   }
 

packages/vkui/src/components/ConfigProvider/ConfigProvider.tsx

@@ -58,17 +58,17 @@ export const ConfigProvider = (props: ConfigProviderProps) => {
 
   if (process.env.NODE_ENVIRONMENT === 'development') {
     // TODO [>=6]: удалить warn
-    let thirdRule = '';
+    let webviewTypeRule = '';
     if (props.webviewType) {
-      thirdRule =
+      webviewTypeRule =
         props.webviewType === WebviewType.INTERNAL
-          ? '3. замените `webviewType={WebviewType.INTERNAL}` на `hasCustomPanelHeaderAfterProp={false}`'
-          : '3. замените `webviewType={WebviewType.VKAPPS}` на `hasCustomPanelHeaderAfterProp={true}`';
+          ? 'замените webviewType={WebviewType.INTERNAL} на hasCustomPanelHeaderAfterProp={false}'
+          : 'замените webviewType={WebviewType.VKAPPS} на hasCustomPanelHeaderAfterProp={true}';
     }
     warn(`[@vkontakte/vk-bridge's deprecated] Если вы используете VK Bridge, то:
 1. используйте хук \`useAppearance()\` из @vkontakte/vk-bridge-react и результат передайте в параметр \`appearance\`;
 2. передайте \`bridge.isWebView()\` в параметр \`isWebView\`;
-${thirdRule}
+${webviewTypeRule}
 
 Подробности см. https://github.com/VKCOM/VKUI/issues/5049
 `);

packages/vkui/src/components/ConfigProvider/ConfigProviderContext.tsx

@@ -35,7 +35,7 @@ export interface ConfigProviderContextInterface {
    *
    * > ⚠️ В **v6** свойство будет удалено (см. https://github.com/VKCOM/VKUI/issues/5049).
    * >
-   * > Используете вместо него новые свойства:
+   * > Используйте вместо него новые свойства:
    * >
    * > - `webviewType={WebviewType.INTERNAL}` -> `hasCustomPanelHeaderAfter={false}`.
    * > - `webviewType={WebviewType.VKAPPS}` -> `hasCustomPanelHeaderAfter={true}`. При необходимости передайте `customPanelHeaderAfterMinWidth={<value>}` (по умолчанию равен `90`).

packages/vkui/src/components/ModalPage/Readme.md

@@ -4,10 +4,10 @@
 
 Если контента на странице достаточно для появления скролла, её можно свайпом раскрыть на весь экран.
 
-> При передачи `hasCustomPanelHeaderAfter` в [ConfigProvider](#/ConfigProvider) модальная страница
-> сверху имеет смещение на высоту [PanelHeader](#/PanelHeader), чтобы кнопка закрытия модальной
-> страницы не перекрывалась пользовательским "плавающим" элементом (например, это может быть панель
-> управления webview).
+> При передаче `hasCustomPanelHeaderAfter` в [ConfigProvider](#/ConfigProvider) модальная страница
+> сверху будет смещена на высоту [PanelHeader](#/PanelHeader), чтобы кнопка закрытия модальной
+> страницы не перекрывалась пользовательским "плавающим" элементом (например, панелью управления
+> webview).
 
 Если у ModalRoot `settlingHeight={100}`, то модалка будет сразу открываться на всю высоту.
 

packages/vkui/src/components/PanelHeader/Readme.md

@@ -11,7 +11,8 @@
 
 > **Важно**
 >
-> Правая часть шапки скрыта по умолчанию, если требуется показать её, передайте в [`ConfigProvider`](https://vkcom.github.io/VKUI/#/ConfigProvider) свойство `hasCustomPanelHeaderAfter={false}`.
+> Правая часть шапки скрыта по умолчанию. Если хотите ее показать, передайте в
+> [`ConfigProvider`](#/ConfigProvider) свойство `hasCustomPanelHeaderAfter={false}`.
 >
 > ⚠️ В v6 значение по умолчанию будет изменено на `false` (см. https://github.com/VKCOM/VKUI/issues/5049).
 

packages/vkui/src/components/PanelHeaderContent/Readme.md

@@ -2,7 +2,8 @@
 
 > **Важно**
 >
-> Правая часть шапки скрыта по умолчанию, если требуется показать её, передайте в [`ConfigProvider`](https://vkcom.github.io/VKUI/#/ConfigProvider) свойство `hasCustomPanelHeaderAfter={false}`.
+> Правая часть шапки скрыта по умолчанию. Если хотите ее показать, передайте в
+> [`ConfigProvider`](#/ConfigProvider) свойство `hasCustomPanelHeaderAfter={false}`.
 >
 > ⚠️ В v6 значение по умолчанию будет изменено на `false` (см. https://github.com/VKCOM/VKUI/issues/5049).
 

packages/vkui/src/components/PullToRefresh/PullToRefresh.tsx

@@ -37,13 +37,19 @@ export interface PullToRefreshProps extends DOMProps, TouchProps, HasChildren {
   /**
    * Будет вызвана для обновления контента (прим.: функция должна быть мемоизированным коллбэком)
    *
-   * > ⚠️ В **v6** необходимо будет самостоятельно вызывать функцию `runTapticImpactOccurred()`
-   * > из `@vkontakte/vk-bridge-react` (см. https://github.com/VKCOM/VKUI/issues/5049).
+   * > ⚠️ **Для разработчиков VK Mini Apps**
    * >
-   * > В рамках **v5** вы уже можете вызывать `runTapticImpactOccurred()` в обработчике `onRefresh()`,
-   * > но с одним условием – необходимо возвращать результат выполнения функции `runTapticImpactOccurred()`,
-   * > чтобы исключить его двойной вызов. Результат функции это `boolean`, если вернётся `true`, то
-   * > для нас это будет отвечать, что вызывать `runTapticImpactOccurred()` со стороны **VKUI** не нужно.
+   * > Сейчас метод под конец выполнения вызывает `runTapticImpactOccurred()`.
+   * >
+   * > В **v6** нужно будет самостоятельно вызывать эту функцию в вашем обработчике `onRefresh()`.
+   * > (см. https://github.com/VKCOM/VKUI/issues/5049). Функцию можете импортировать её из
+   * > бибилиотеки `@vkontakte/vk-bridge-react`.
+   * >
+   * > Чтобы подготовить ваше мини-приложение к обновлению до **v6**, в рамках **v5** вы уже можете
+   * > вызывать `runTapticImpactOccurred()`, но с одним условием: вы должны вернуть результат
+   * > выполнения функции, чтобы исключить двойной вызов. Результат функции — `boolean`. Если
+   * > вернётся `true`, значит, вызывать `runTapticImpactOccurred()` снова со стороны **VKUI** —
+   * > не нужно.
    * >
    * > ```jsx
    * > const onRefresh = React.useCallback(() => {

styleguide/pages/integrations_vk_mini_apps.md

@@ -1,15 +1,33 @@
+> **Предусловие**
+>
+> Изначально, **VKUI** создавался как инструмент для создания клиентской части мини-приложений
+> [ВКонтакте](https://vk.com). В связи с этим, до версии **v5** включительно, **VKUI** содержит интеграцию с
+> библиотекой [VK Bridge](https://www.npmjs.com/package/@vkontakte/vk-bridge), которая реализует
+> общение между [VK Mini Apps](<(https://vk.com/miniapps)>) и официальными клиентами [ВКонтакте](https://vk.com).
+>
+> Сейчас **VKUI** уже больше чем просто мини-приложения. Разработчики используют библиотеку, чтобы
+> создавать полноценные независимые приложения, которые никак не связаны с [VK Mini Apps](https://vk.com/miniapps).
+> Но тем не менее им приходится иметь дело с этим наследием.
+>
+> Чтобы отделить **VKUI** от [VK Mini Apps](https://vk.com/miniapps), начиная с версии **v6** будет
+> удалена интеграция с [VK Bridge](https://www.npmjs.com/package/@vkontakte/vk-bridge).
+>
+> В рамках **v5** добавлены советы по подготовке к обновлению на **v6**. Вам они будут попадаться на
+> других страницах документации, а также в предупреждениях в **DevTools** (☝️ если вы не разработчик
+> [VK Mini Apps](https://vk.com/miniapps), то просто игнорируйте эти советы).
+
 [VK Mini Apps](https://vk.com/miniapps) – это кроссплатформенные мини-приложения в экосистеме социальной сети [ВКонтакте](https://vk.com/).
 
-**VKUI** изначально создавался для создания таких приложений. Несмотря на то, что сейчас **VKUI**
-это уже больше чем мини-приложения, он до сих пор хорошо подходит для их создания. Ниже
-собраны советы по интеграции c **VK Mini Apps**.
+**VKUI** изначально создавался как библиотека компонентов для таких приложений. Несмотря на то, что
+сейчас **VKUI** — больше, чем мини-приложения, он до сих пор хорошо подходит для них. Ниже мы
+собрали советы по интеграции с **VK Mini Apps**.
 
-Про саму разработку **VK Mini Apps** читайте здесь https://dev.vk.com/mini-apps/overview
+Про саму разработку **VK Mini Apps** читайте [статью "Мини-приложения" на портале VK для разработчиков](https://dev.vk.com/mini-apps/overview).
 
 ## Конфигурация VKUI
 
-> Советуем использовать шаблон https://github.com/VKCOM/create-vk-mini-app. В ней конфигурация
-> описанная ниже есть по умолчанию.
+> Советуем использовать шаблон [@vkontakte/create-vk-mini-app](https://github.com/VKCOM/create-vk-mini-app).
+> В нем конфигурация, описанная ниже, есть по умолчанию.
 
 Для начала устанавливаем библиотеки:
 
@@ -116,16 +134,16 @@ export const transformVKBridgeAdaptivity = (vkBridgeAdaptivity: UseAdaptivity):
 требуется.
 
 > _Правый верхний угол_ [PanelHeader](https://vkcom.github.io/VKUI/#/PanelHeader) зарезервирован для
-> нативного бара с кнопками управления мини-приложенияем, поэтому не рекомендуется использовать
+> нативного бара с кнопками управления мини-приложением, поэтому не рекомендуем использовать
 > параметр `after`.
 >
 > Чтобы автоматически скрывать `after` у [PanelHeader](https://vkcom.github.io/VKUI/#/PanelHeader),
-> в [ConfigProvider](https://vkcom.github.io/VKUI/#/ConfigProvider) существует параметр
+> в [ConfigProvider](https://vkcom.github.io/VKUI/#/ConfigProvider) есть параметр
 > `hasCustomPanelHeaderAfter`.
 
 ### [View](https://vkcom.github.io/VKUI/#/View)
 
-На стартовой странице мини-приложения необходимо включать свайпбек нативного клиента, чтобы
+На стартовой странице мини-приложения вы должны включить свайпбек нативного клиента, чтобы
 пользователь смог выйти из мини-приложения. Для этого нужно вызывать определенные методы
 **VK Bridge** в зависимости от типа мини-приложения:
 
@@ -172,14 +190,14 @@ const SomeViews = () => {
 
 > На устройствах с Android нажатие кнопки **Назад** вызывает в WebView событие [history.back](https://developer.mozilla.org/ru/docs/Web/API/Window/history).
 > По нажатию этой кнопки официальное приложение сделает возврат на предыдущую страницу вашего
-> приложения или закроет его, если вернуться невозможно. Поэтому для корректной навигации необходимо
-> обрабатывать нажатие аппаратной клавиши в мини-приложении и реализовывать роутинг. Например при
-> помощи библиотеки `react-router`.
+> приложения или закроет его, если вернуться невозможно. Поэтому для корректной навигации вы должны
+> обрабатывать нажатие аппаратной клавиши в мини-приложении и реализовывать роутинг. Сделать это
+> можно, например, при помощи библиотеки `react-router`.
 
 ## Виброотклик (Taptic Engine)
 
-Для улучшения пользовательского опыта при взаимодействие с вашим мини-приложением, в **VK Bridge**
-существует события вызова вибрации на устройстве, если те поддерживается.
+Для улучшения пользовательского опыта при взаимодействии с вашим мини-приложением в **VK Bridge**
+существуют события вызова вибрации на устройстве, которое их поддерживает.
 
 [@vkontakte/vk-bridge-react](https://www.npmjs.com/package/@vkontakte/vk-bridge) предоставляет
 функцию `runTapticImpactOccurred`, которая отправляет событие [VKWebAppTapticImpactOccurred](https://dev.vk.com/bridge/VKWebAppTapticImpactOccurred),

styleguide/pages/intro.md

@@ -1,26 +1,4 @@
-**VKUI** — это библиотека адаптивных React-компонентов, для создания веб-приложений.
-
-> **Подготовка к отвязке от [VK Mini Apps](https://vk.com/miniapps)**
->
-> Изначально, **VKUI** создавался как инструмент для создания клиентской части мини-приложений
-> [ВКонтакте](https://vk.com). В связи с этим, до версии **v5** включительно, **VKUI** содержит интеграцию с
-> библиотекой [VK Bridge](https://www.npmjs.com/package/@vkontakte/vk-bridge), которая реализует
-> общение между [VK Mini Apps](<(https://vk.com/miniapps)>) и официальными клиентами [ВКонтакте](https://vk.com).
->
-> Сейчас **VKUI** уже больше чем просто мини-приложения. Разработчики используют библиотеку, чтобы
-> создавать полноценные независимые приложения, которые никак не связаны с [VK Mini Apps](https://vk.com/miniapps).
-> Но тем не менее им приходится иметь дело с этим наследием.
->
-> Чтобы отделить **VKUI** от [VK Mini Apps](https://vk.com/miniapps), начиная с версии **v6** будет
-> удалена интеграция с [VK Bridge](https://www.npmjs.com/package/@vkontakte/vk-bridge).
->
-> В рамках **v5** внесены следующие подготовительные изменения:
->
-> - добавлены советы по подготовке к обновлению на **v6** – в документации и в
->   предупреждениях в **DevTools** (☝️ если вы не разработчик [VK Mini Apps](https://vk.com/miniapps),
->   то просто игнорируйте эти советы);
-> - создана страница [Интеграция с VK Mini Apps](https://vkcom.github.io/VKUI/#/integrations-vk-mini-apps),
->   которая содержит всю информацию об интеграции **VKUI** с [VK Mini Apps](https://vk.com/miniapps).
+**VKUI** — это библиотека адаптивных React-компонентов для создания веб-приложений.
 
 Библиотека основана на [дизайн-системе ВКонтакте](https://www.figma.com/@vk) и реализует её интерфейсы для различных платформ.