Документы Yellowbe

Исправление стилей списков

See merge request common/vega/beecloud-docs!25

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "docs",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "docs",
-      "version": "0.5.0",
+      "version": "0.6.1",
       "license": "MIT",
       "dependencies": {
         "@beeline/design-tokens": "^1.31.0",

src/.vitepress/config.mts

@@ -90,8 +90,8 @@ export default defineConfig({
       }
     },
     // https://vitepress.dev/reference/default-theme-config
-  // nav: [
+    // nav: [
-  //   ],
+    //   ],
 
     //  socialLinks: [
     //    { icon: { svg: gitlab }, link: 'https://git.vimpelcom.ru/common/vega/docs' }
@@ -118,88 +118,124 @@ export default defineConfig({
       label: 'Содержание'
     },
     sidebar: {
-    '/platform/': [
+      '/platform/': [
-      {
+        {
-        text: 'Платформа Beeline Cloud', link: '/platform/index.md',
+          text: 'Платформа Beeline Cloud', link: '/platform/index.md',
-        collapsed: true,
+          collapsed: true,
           items: [
-            {text: 'Сервисы', link: '/platform/services/services.md'},
+            { text: 'Сервисы', link: '/platform/services/services.md' },
-            {text: 'Техническая поддержка', link: '/platform/support/support-overview.md'}, 
+            { text: 'Техническая поддержка', link: '/platform/support/support-overview.md' },
           ],
         },
       ],
-    '/start/': [
+      '/start/': [
-      {
+        {
-        text: 'Начало работы в Beeline Cloud', link: '/start/index.md',
+          text: 'Начало работы в Beeline Cloud', link: '/start/index.md',
-        collapsed: true,
+          collapsed: true,
           items: [
-            {text: 'Начать работу', link: '/start/getting-started.md'},
+            { text: 'Начать работу', link: '/start/getting-started.md' },
-            {text: 'Бесплатный период', link: '/start/trial.md'}, 
+            { text: 'Бесплатный период', link: '/start/trial.md' },
-            {text: 'Платное использование', link: '/start/organization.md'},
+            { text: 'Платное использование', link: '/start/organization.md' },
           ],
         },
       ],
-    //  '/billing/': [
+      //  '/billing/': [
 
-    //   ],
+      //   ],
       '/vdc/': [
         {
-        text: 'Виртуальные дата-центры на VMware', link: '/vdc/index.md',
+          text: 'Виртуальные дата-центры на VMware', link: '/vdc/index.md',
-        collapsed: true,
+          collapsed: true,
           items: [
-            {text: 'Обзор сервиса', link: '/vdc/vdc-overview.md'},
+            { text: 'Обзор сервиса', link: '/vdc/vdc-overview.md' },
-            {text: 'Быстрый старт', link: '/vdc/vdc-getting-started.md'}, 
+            { text: 'Быстрый старт', link: '/vdc/vdc-getting-started.md' },
-            {text: 'Виртуальные дата-центры', link: '/vdc/vdc-how-to/vdc-index.md',
+            {
-            collapsed: true,
+              text: 'Виртуальные дата-центры', link: '/vdc/vdc-how-to/vdc-index.md',
-            items: [
-            { text: 'Создание дата-центра', link: '/vdc/vdc-how-to/vdc-create.md' },
-            { text: 'Вход в дата-центр', link: '/vdc/vdc-how-to/vdc-enter.md' },
-            { text: 'Управление дата-центром', link: '/vdc/vdc-how-to/vdc-manage.md' },
-            { text: 'Двухфакторная аутентификация', link: '/vdc/vdc-how-to/vdc-2fa.md', 
               collapsed: true,
               items: [
-              {text: 'Подключение 2FA', link: '/vdc/vdc-how-to/vdc-2fa-start.md'},
+                { text: 'Создание дата-центра', link: '/vdc/vdc-how-to/vdc-create.md' },
-              {text: 'Управление 2FA', link: '/vdc/vdc-how-to/vdc-2fa-manage.md'},      
+                { text: 'Вход в дата-центр', link: '/vdc/vdc-how-to/vdc-enter.md' },
+                { text: 'Управление дата-центром', link: '/vdc/vdc-how-to/vdc-manage.md' },
+                {
+                  text: 'Двухфакторная аутентификация', link: '/vdc/vdc-how-to/vdc-2fa.md',
+                  collapsed: true,
+                  items: [
+                    { text: 'Подключение 2FA', link: '/vdc/vdc-how-to/vdc-2fa-start.md' },
+                    { text: 'Управление 2FA', link: '/vdc/vdc-how-to/vdc-2fa-manage.md' },
+                  ],
+                },
               ],
             },
-           ],
+            // { text: 'Тарификация', link: '/vdc/vdc-tarif.md' },
-          },
-           // { text: 'Тарификация', link: '/vdc/vdc-tarif.md' },
           ],
         },
-       ],
+      ],
       '/compute/': [
         {
-        text: 'Виртуальные машины', link: '/compute/index.md',
+          text: 'Виртуальные машины', link: '/compute/index.md',
-        collapsed: true,
+          collapsed: true,
           items: [
-            {text: 'Обзор сервиса', link: '/compute/compute-overview.md'},
+            { text: 'Обзор сервиса', link: '/compute/compute-overview.md' },
-          //  {text: 'Быстрый старт', link: '/compute/compute-getting-started.md'}, 
+            //  {text: 'Быстрый старт', link: '/compute/compute-getting-started.md'}, 
-            {text: 'Виртуальные машины', link: '/compute/compute-how-to/compute-index.md',
+            {
-                collapsed: true,
+              text: 'Виртуальные машины', link: '/compute/compute-how-to/compute-index.md',
-                items: [
+              collapsed: true,
+              items: [
                 { text: 'Создание ВМ', link: '/compute/compute-how-to/compute-servers-create.md' },
                 { text: 'Подключение к ВМ', link: '/compute/compute-how-to/compute-connect.md' },
                 { text: 'Управление ВМ', link: '/compute/compute-how-to/compute-servers-manage.md' },
-                ],
+              ],
-              },
+            },
             { text: 'Диски', link: '/compute/compute-how-to/compute-disks.md' },
             { text: 'IP-адреса', link: '/compute/compute-how-to/compute-ip.md' },
             { text: 'Группы размещения', link: '/compute/compute-how-to/compute-affinity.md' },
+            {
+              text: 'Практические руководства', link: '/compute/compute-guide/compute-guide-index.md',
+              collapsed: true,
+              items: [
+                { text: 'Подключение по SSH к ВМ закрытого контура', link: '/compute/compute-guide/compute-guide-ssh-inside.md' },
+              ],
+            },
           ],
         },
 
-          ],
+      ],
       '/admin/': [
-      {
+        {
-        text: 'Аккаунт Beeline Cloud', link: '/admin/acc-index.md',
+          text: 'Аккаунт Beeline Cloud', link: '/admin/index.md',
-        collapsed: true,
+          collapsed: true,
           items: [
-            {text: 'Управление ключевыми парами', link: '/admin/ssh.md'},
+            { text: 'Управление ключевыми парами', link: '/admin/ssh.md' },
+          ],
+        },
+      ],
+      '/yellowbe/': [
+        {
+          text: 'Дизайн-платформа Yellowbe', link: '/yellowbe/index.md',
+          collapsed: false,
+          items: [
+            {
+              text: 'Начать работу',
+              link: '/yellowbe/get-started/index.md',
+              collapsed: true,
+              items: [
+                {
+                  text: 'Разработчику',
+                  link: '/yellowbe/get-started/dev.md',
+                }, {
+                  text: 'Дизайнеру',
+                  link: '/yellowbe/get-started/design.md',
+                },
+              ]
+            },
+            {
+                  text: 'Состав дизайн-платформы',
+                  link: '/yellowbe/about.md',
+            }
           ],
         },
       ],
-      },  
     },
-  }
+  },
+}
 )

src/.vitepress/theme/scss/components/vp-doc.scss

@@ -1,3 +1,6 @@
+@use "@beeline/design-tokens/scss/tokens/globals/colors";
+@use "@beeline/design-tokens/scss/tokens/themes";
+
 @mixin font_style($fontSize, $fontWeight, $lineHeight, $letterSpacing) {
     font-size: $fontSize;
     font-weight: $fontWeight;
@@ -66,7 +69,7 @@
     }
 
     li + li {
-        margin-top: 50px;
+        margin-top: 34px;
     }
 
     ul li {
@@ -75,16 +78,6 @@
         margin-top: 8px;
     }
     
-    ol li:nth-last-of-type(n+2)::after {
-        content: '';
-        border-left: 1px solid rgb(201, 197, 197);
-        position: absolute;
-        line-height: 100%;
-        left: -30px;
-        top: 43px;
-        bottom: -30px;
-    }
-
     ol li::before {
         content: counter(list);
         counter-increment: list;
@@ -94,8 +87,8 @@
         left: -48px;
         width: 35px;
         height: 35px;
-        background-color: #7e00ed;
+        background-color: colors.$color-background-brand;
-        color: #fff;
+        color: themes.$color-text-active;
         text-align: center;
         line-height: 25px;
         font-size: 16px;
@@ -115,6 +108,10 @@
         padding: 0;
     }
 
+    ol li:last-child, ul li:last-child {
+        margin-bottom: 40px;
+    }
+
     ol li p {
         margin-top: 0;
     }

src/admin/acc-index.md

@@ -1,10 +0,0 @@
----
-section_links:
-  - title: Управление ключевыми парами
-    link: /admin/ssh.md
-    description: Добавление SSH-ключей для подключения к виртуальным машинам 
---- 
-
-# Аккаунт Beeline Cloud
-
-Аккаунт Beeline Cloud создается при [регистрации пользователя](../start/getting-started.md#1-регистрация-в-beeline-cloud) в Beeline Cloud. С помощью аккаунта можно управлять профилем пользователя.

src/admin/index.md

@@ -0,0 +1,10 @@
+---
+section_links:
+  - title: Управление ключевыми парами
+    link: /admin/ssh.md
+    description: Добавление SSH-ключей для подключения к виртуальным машинам 
+--- 
+
+# Аккаунт Beeline Cloud
+
+Аккаунт Beeline Cloud создается при [регистрации пользователя](../start/getting-started.md#1-регистрация-в-beeline-cloud) в Beeline Cloud. С помощью аккаунта можно управлять профилем пользователя.

src/compute/compute-guide/compute-guide-index.md

@@ -0,0 +1,11 @@
+---
+section_links:
+  - title: Подключение по SSH к виртуальной машине закрытого контура
+    link: /compute/compute-guide/compute-guide-ssh-inside.md
+    description: Получение доступа из интернета к виртуальной машине закрытого контура
+---  
+
+# Практические руководства
+
+Рассмотрены сценарии использования сервиса **Виртуальные машины**.
+

src/compute/compute-guide/compute-guide-ssh-inside.md

@@ -0,0 +1,100 @@
+# Подключение по SSH к виртуальным машинам закрытого контура
+
+Виртуальные машины, созданные в [закрытом контуре (зоне доступности `Inside`)](../compute-overview.md#зоны-доступности), недоступны из интернета. Чтобы подключиться по SSH к ВМ закрытого контура, используйте промежуточную виртуальную машину (джамп-хост) с публичным IP-адресом в интернете.
+
+## Перед началом работы
+
+- Публичный IP-адрес [доступен для назначения](../compute-how-to/compute-ip.md#назначить-вм-публичный-ip-адрес).
+- Подготовлена ключевая пара для подключения к ВМ по SSH:
+  - приватный ключ сохранен на компьютере, с которого выполняется подключение;
+  - публичный ключ [добавлен](../../admin/ssh.md#добавить-ssh-ключ) в профиль пользователя в личном кабинете Beeline Cloud.
+
+Если вы используете разные SSH-ключи для подключения к ВМ закрытого контура и к ВМ с публичным IP-адресом, то добавьте оба публичных ключа в профиль пользователя в личном кабинете Beeline Cloud.
+
+## Посмотреть публичный IP-адрес
+
+1. Войдите в [личный кабинет](https://lk.cloud.beeline.ru/).
+2. Выберите нужный проект в верхнем меню **Проекты**.
+3. В верхнем меню нажмите на пункт **Сервисы** и выберите сервис **Виртуальные машины**.
+4. В левом меню откройте раздел **IP-адреса**.
+5. Отобразится список всех IP-адресов проекта.
+6. Если для публичного IP-адреса отображается статус `Зарезервирован`, то публичный IP-адрес [доступен для назначения](../compute-how-to/compute-ip.md#назначить-вм-публичный-ip-адрес).
+
+## Создать джамп-хост
+
+Джамп-хост — это виртуальная машина с публичным IP-адресом, созданная в зоне доступности `DMZ`.
+
+1. Войдите в [личный кабинет](https://lk.cloud.beeline.ru/).
+2. Выберите нужный проект в верхнем меню **Проекты**.
+3. В верхнем меню нажмите на пункт **Сервисы** и выберите сервис **Виртуальные машины**.
+4. В левом меню откройте раздел **Виртуальные машины**.
+5. Нажмите **Создать виртуальную машину**.
+6. В блоке **Имя и расположение** укажите имя и расположение ВМ:
+   - **Имя машины**: введите название ВМ.
+   - **Зона доступности**: выберите зону доступности, содержащую в названии `DMZ`.
+   :::warning Важно
+   Джамп-хост и публичный IP-адрес должны находиться в одной [зоне доступности](./../compute-overview.md#зоны-доступности).
+   :::
+7. В блоке **Выбор образа** выберите [тип и версию операционной системы](./../compute-overview.md#операционная-система).
+8. В блоке **Конфигурация** выберите количество vCPU и RAM.
+9. В блоке **Диски** настройте загрузочный диск:
+    - **Загрузочный диск**: выберите [тип диска](../compute-overview.md#диски) и укажите размер загрузочного диска.
+10. Выберите публичный ключ для подключения к ВМ по SSH.
+11. В блоке **Настройки сети** выберите:
+    - **IPv4-адрес**: выберите из списка публичный IP-адрес.
+12. Нажмите **Создать виртуальную машину**.
+
+## Создать ВМ в закрытом контуре
+
+Если ВМ в закрытом контуре уже создана, то пропустите этот шаг.
+
+1. Войдите в [личный кабинет](https://lk.cloud.beeline.ru/).
+2. Выберите нужный проект в верхнем меню **Проекты**.
+3. В верхнем меню нажмите на пункт **Сервисы** и выберите сервис **Виртуальные машины**.
+4. В левом меню откройте раздел **Виртуальные машины**.
+5. Нажмите **Создать виртуальную машину**.
+6. В блоке **Имя и расположение** укажите имя и расположение ВМ:
+   - **Имя машины**: введите название ВМ.
+   - **Зона доступности**: выберите зону доступности, содержащую в названии `Inside`.
+7. В блоке **Выбор образа** выберите [тип и версию операционной системы](./../compute-overview.md#операционная-система).
+8. В блоке **Конфигурация** выберите количество vCPU и RAM.
+9. В блоке **Диски** настройте загрузочный диск:
+    - **Загрузочный диск**: выберите [тип диска](../compute-overview.md#диски) и укажите размер загрузочного диска.
+10. Выберите публичный ключ для подключения к ВМ по SSH.
+11. В блоке **Настройки сети** выберите:
+    - **IPv4-адрес**: выберите `Автоматически`, ВМ будет назначен внутренний IP-адрес.
+12. Нажмите **Создать виртуальную машину**.
+
+## Конфигурация SSH
+
+1. Откройте конфигурационный файл SSH `~/.ssh/config` для ОС Linux или `C:\users\имя_пользователя\.ssh\config` для ОС Windows.
+2. Добавьте в конфигурационный файл сведения о виртуальных машинах:
+   
+   ```
+   host jumphost
+        hostname <foo-host>
+        user <foo-login>
+        IdentityFile <foo-secret-file-path>
+
+   host myhost
+        hostname <bar-another-host>
+        user <bar-login>
+        IdentityFile <bar-secret-file-path>
+        ProxyJump jumphost
+    ```
+    где:
+     - `foo-host`: публичный IP-адрес джамп-хоста;
+     - `foo-login`: [имя пользователя ОС по умолчанию](./../compute-overview.md#операционная-система) на джамп-хосте;
+     - `foo-secret-file-path`: путь к приватному ключу джамп-хоста;
+     - `bar-another-host`: внутренний IP-адрес ВМ, к которой требуется подключиться;
+     - `bar-login`: [имя пользователя ОС по умолчанию](./../compute-overview.md#операционная-система) на ВМ. к которой требуется подключиться;
+     - `bar-secret-file-path`: путь к приватному ключу ВМ, к которой требуется подключиться;
+
+## Подключиться к ВМ закрытого контура
+
+1. Откройте терминал.
+2. Выполните команду:
+   
+   ```
+   ssh myhost
+   ```

src/compute/compute-how-to/compute-connect.md

@@ -1,36 +1,55 @@
-# Подключение к ВМ
+# Подключение к виртуальной машине
 
 Подключение к ВМ выполняется по протоколу SSH с [помощью ключевой пары](../../admin/ssh.md).
 
+:::tip Информация
+Чтобы подключаться к виртуальной машине по SSH, [добавьте](../../admin/ssh.md#добавить-ssh-ключ) публичный ключ в профиль пользователя перед созданием виртуальной машины. Для существующих виртуальных машин добавление SSH-ключа невозможно.
+:::
+
 ## Перед началом работы
 
-- Статус ВМ `Включен`.
+Перед подключением проверьте выполнение условий и наличие данных:
+
+- Статус виртуальной машины — `Включена`.
+- Виртуальной машине [назначен](../compute-how-to/compute-ip.md#назначить-вм-публичный-ip-адрес) публичный IP-адрес.
+- Узнайте [имя пользователя ОС по умолчанию](../compute-overview.md#операционная-система).
+- Приватный ключ сохранен на компьютере, с которого выполняется подключение.
+
+:::tip Информация
+
+Чтобы [подключиться](../compute-guide/compute-guide-ssh-inside.md) к виртуальной машине закрытого контура, используйте как джамп-хост виртуальную машину с публичным IP-адресом.
+
+:::
 
 ## Подключиться к ВМ
 
 1. Откройте терминал.
 2. Выполните команду в терминале:
-
+     ```
-   - **подключиться из интернета к ВМ, созданной в зоне `DMZ`**:
+     ssh -l <логин>@<публичный_IP>
-
+     ```
-      ```
-      ssh -l <имя пользователя> <публичный IP-адрес ВМ>
-      ```
      где: 
 
-     - `имя пользователя`: имя пользователя ВМ соответствует [названию операционной системы ВМ](./../compute-overview.md#операционная-система), но с маленькой буквы и без указания версии ОС;
+     - `логин`: [имя пользователя ОС по умолчанию](./../compute-overview.md#операционная-система);
-     - `публичный IP-адрес ВМ`: публичный IP-адрес ВМ можно узнать на странице сервиса **Виртуальные машины** в разделе **Виртуальные машины**, нажмите на имя ВМ и скопируйте IP-адрес.
+     - `публичный_IP`: публичный IP-адрес виртуальной машины можно узнать на странице сервиса **Виртуальные машины** в разделе **Виртуальные машины**.
 
-   - **подключиться из интернета к ВМ, созданной в зоне `Inside`**:
+   - Если на вашем устройстве есть несколько приватных ключей или вы переместили приватный ключ из каталога по умолчанию, то дополнительно укажите путь к приватному ключу:
 
-      ```
+     ```
-      ssh -o ProxyJump=<имя пользователя1>@<публичный IP-адрес ВМ> <имя пользователя2>@<приватный IP-адрес ВМ>
+     ssh -o IdentityFile=<путь_к_приватному_ключу> <логин>@<публичный_IP>
-      ```
+     ```
-     где:
-     - `имя пользователя1`: имя пользователя ВМ, через которую будет выполнено подключение к ВМ `Inside`-зоны, соответствует [названию операционной системы ВМ](./../compute-overview.md#операционная-система), но с маленькой буквы и без указания версии ОС;
-     - `имя пользователя2`: имя пользователя ВМ `Inside`-зоны, соответствует [названию операционной системы ВМ](./../compute-overview.md#операционная-система), но с маленькой буквы и без указания версии ОС;
-     - `публичный IP-адрес ВМ`: публичный IP-адрес ВМ, через которую будет выполнено подключение к ВМ `Inside`-зоны;
-     - `приватный IP-адрес ВМ`: приватный IP-адрес ВМ `Inside`-зоны, к которой нужно подключиться из интернета;
-     - IP-адреса ВМ можно узнать на странице сервиса **Виртуальные машины** в разделе **Виртуальные машины**, нажмите на имя ВМ и скопируйте IP-адрес.
 
 3. Подтвердите подключение.
+
+## Пример команды для подключения к ВМ
+
+::::tabs
+= Linux/macOS
+```
+ssh -o IdentityFile=~/.ssh/id_ed25519 debian@<публичный_IP>
+```
+= Windows 10/11
+```
+ssh -o IdentityFile=%USERPROFILE%\.ssh\id_ed25519 debian@<публичный_IP>
+```
+::::

src/compute/compute-how-to/compute-ip.md

@@ -1,29 +1,36 @@
 # IP-адрес
 
-IP-адрес — это вычислительный ресурс облака. В облачных сервисах используются внутренние IPv4-адреса.
+IP-адрес — это вычислительный ресурс облака. В сервисе **Виртуальные машины** поддерживаются только IPv4-адреса
 
-Внутренние IP-адреса назначаются автоматически или выбираются из списка зарезервированных адресов при создании ВМ.
+Адреса могут быть внутренними или публичными.
 
-Список зарезервированных адресов формируется из:
+Внутренние IP-адреса формируются из диапазона IP-адресов:
--  IP-адресов, [созданных вручную](#создать-ip-адрес);
+
--  IP-адресов, [сохраненных в проекте](#сохранить-ip-адрес-в-проекте).
+- автоматически при [создании ВМ](./compute-servers-create.md#создать-виртуальную-машину);
+- [создаются вручную](#создать-ip-адрес).
+
+Публичный IP-адрес выдается организации при регистрации аккаунта Beeline Cloud.
 
 ::: warning Важно
-Привязка и отвязка IP-адресов возможна внутри одной [зоны доступности](../compute-overview.md#зоны-доступности).
+Одной организации предоставляется один публичный IP-адрес.
 :::
 
-## Типы IP-адресов
+## Внутренние IP-адреса
 
-`Публичный` — IP-адрес, по которому ВМ доступна из интернета.
+Внутренний IP-адрес назначается виртуальной машине автоматически или выбираются из списка зарезервированных адресов при ее создании.
 
-`Приватный` — IP-адрес, по которому ВМ доступна в [зоне `Inside`](../compute-overview.md#зоны-доступности).
+Внутренний IP-адрес используется для взаимодействия между ВМ внутри одной сети. Внутренний IP-адрес не виден из интернета.
 
-::: warning Важно
+:::tip Информация
-Один публичный IP-адрес предоставляется одной организации. Не удаляйте публичный IP-адрес из списка IP-адресов. В случае удаления IP-адреса пропадет возможность создания ВМ с доступом в интернет.
+Виртуальная машина доступна из интернета только через публичный IP-адрес. Для доступа из интернета к виртуальной машине по внутреннему IP-адресу используйте виртуальную машину с публичным IP-адресом как джамп-хост.
-
-Публичный IP-адрес можно отвязать от ВМ и назначить другой ВМ.
 :::
 
+## Публичные IP-адреса
+
+Публичный IP-адрес — это внешний IP-адрес, который используется для выхода в интернет. В сервисе **Виртуальные машины** публичный IP-адрес является плавающим адресом (floating IP), который можно [переназначать](#назначить-вм-публичный-ip-адрес) между виртуальными машинами.
+
+Публичный IP-адрес [назначается](#назначить-вм-публичный-ip-адрес) виртуальной машине при ее создании. Существующей ВМ назначить публичный IP-адрес нельзя.
+
 ## Статусы IP-адресов
 
 `Используется` — IP-адрес зарезервирован и назначен ВМ.
@@ -53,11 +60,26 @@ IP-адрес — это вычислительный ресурс облака.
    - добавьте тег адресу при необходимости.
 7. Нажмите **Создать**.
 
-На странице **Облачные вычисления → IP-адреса** появится новый IP-адрес со статусом `Зарезервирован`.
+На странице **Виртуальные машины → IP-адреса** появится новый IP-адрес со статусом `Зарезервирован`.
+
+## Назначить ВМ публичный IP-адрес
+
+Публичный IP-адрес можно привязать ВМ при условиях:
+
+- IP-адрес находится в статусе `Зарезервирован`;
+- виртуальная машина и публичный IP-адрес находятся в одной [зоне доступности](./../compute-overview.md#зоны-доступности);
+- публичный IP-адрес можно назначить только новой ВМ, существующей ВМ привязать публичный IP-адрес не получится.
+
+Чтобы привязать публичный IP-адрес новой ВМ, то при создании ВМ в поле **IPv4-адрес** выберите публичный IP-адрес.
+
+Если вам требуется отвязать публичный IP-адрес от существующей ВМ:
+
+- убедитесь, что для IP-адреса не указан признак `Автоудаление`, при необходимости [снимите признак `Автоудаление`](#сохранить-ip-адрес-в-проекте) у IP-адреса;
+- [удалите ВМ](./compute-servers-manage.md#удалить-вм).
 
 ## Сохранить IP-адрес в проекте
 
-При удалении ВМ его IP-адрес освобождается и не может быть повторно использован в проекте. Если вам требуется сохранить IP-адрес ВМ и привязать этот адрес новой ВМ, то отключите автоудаление адреса. IP-адрес сохранится в вашем проекте и может быть назначен новой ВМ.
+При удалении ВМ её IP-адрес удаляется и не может быть повторно использован в проекте. Если вам требуется сохранить IP-адрес и использовать его для другой ВМ, то отключите автоудаление адреса. IP-адрес сохранится в вашем проекте и может быть назначен новой ВМ.
 
 1. Войдите в [личный кабинет](https://lk.cloud.beeline.ru/).
 2. Выберите нужный проект в верхнем меню **Проекты**.
@@ -70,7 +92,7 @@ IP-адрес — это вычислительный ресурс облака.
 
 ## Присвоить имя IP-адресу
 
-Имя IP-адреса отображается только на странице **Облачные вычисления → IP-адреса**. На странице ВМ отображается значение IP-адреса.
+Имя IP-адреса отображается только на странице **Виртуальные машины → IP-адреса**. На параметрах виртуальной машины отображается значение IP-адреса.
 
 1. Войдите в [личный кабинет](https://lk.cloud.beeline.ru/).
 2. Выберите нужный проект в верхнем меню **Проекты**.
@@ -83,6 +105,10 @@ IP-адрес — это вычислительный ресурс облака.
 
 ## Удалить IP-адрес
 
+:::warning Важно
+Не удаляйте публичный IP-адрес из списка IP-адресов. В случае удаления IP-адреса пропадет возможность создания ВМ с доступом в интернет.
+:::
+
 Если для IP-адреса установлено автоудаление, то адрес удалится во время удаления ВМ.
 
 Если для IP-адреса не установлено автоудаление, то адрес удаляется вручную:

src/compute/compute-how-to/compute-servers-create.md

@@ -9,37 +9,33 @@
 5. Нажмите **Создать виртуальную машину**.
 6. В блоке **Имя и расположение** укажите имя и расположение ВМ:
    - **Имя машины**: введите название ВМ:
-     - допустимая длина 63 символа с учетом зоны DNS проекта;
+     - длина от 3 до 63 символов;
+     - используйте только строчные латинские буквы, цифры и дефис;
+     - не используйте дефис в начале или в конце имени.
    - **Зона доступности**: выберите подходящую [зону доступности](../compute-overview.md#зоны-доступности).
-   - Укажите количество создаваемых ВМ.
 7. В блоке **Выбор образа** выберите [тип и версию операционной системы](./../compute-overview.md#операционная-система).
-8. В блоке **Конфигурация** выберите количество ОЗУ и ЦПУ. Наборы ресурсов заранее скомпонованы по оптимальным параметрам.
+8. В блоке **Конфигурация** выберите количество vCPU и RAM. Наборы ресурсов заранее скомпонованы по оптимальным параметрам.
    ::: tip Информация
-   При выборе ресурсов рекомендуется в первую очередь ориентироваться на требуемое количество ОЗУ.
+   При выборе ресурсов рекомендуется в первую очередь ориентироваться на требуемое количество RAM.
    :::
 9.  В блоке **Диски** настройте загрузочный диск и, при необходимости, добавьте дополнительные диски:
-    - **Загрузочный диск**: выберите тип хранения и укажите размер загрузочного диска.
+    - **Загрузочный диск**: выберите [тип диска](../compute-overview.md#диски) и укажите размер загрузочного диска.
     - Рекомендуется создать дополнительный диск для размещения ваших данных: нажмите **Добавьте диск** и настройте дополнительный диск. [Дополнительный диск можно создать](#добавить-диск) позже.
     ::: warning Важно
     К ВМ можно подключить не более 28 дисков, включая загрузочный.
     :::
-10.  Выберите SSH-ключи, с помощью которых вы можете подключаться к ВМ по SSH. Если подходящий SSH-ключ отсутствует, то нажмите [**Создать ключ**](../../admin/ssh.md#создать-ssh-ключ).
+10.   Выберите SSH-ключи, с помощью которых вы можете подключаться к ВМ по SSH. Если подходящий SSH-ключ отсутствует, то нажмите [**Создать ключ**](../../admin/ssh.md#создать-ssh-ключ).
-11.  В блоке **Настройки сети** выберите:
+11.   В блоке **Настройки сети** выберите:
-    - **IPv4-адрес**: выберите способ получения внутреннего IP-адреса для ВМ:
+    - **IPv4-адрес**: выберите способ получения IP-адреса для ВМ:
-      - выберите **Автоматически**, чтобы получить IP-адрес автоматически;
+      - выберите **Автоматически**, чтобы получить IP-адрес автоматически, автоматически назначаются [внутренние IP-адреса](compute-ip.md#внутренние-ip-адреса);
-      - выберите адрес из списка. В списке адресов отображаются [созданные вручную IP-адреса](compute-ip.md#создать-ip-адрес) и [сохраненные IP-адреса](compute-ip.md#сохранить-ip-адрес-в-проекте), которые доступны для переиспользования.
+      - выберите адрес из списка. В списке адресов отображается [зарезервированные IP-адреса](compute-ip.md#статусы-ip-адресов).
-      ::: warning Важно
+12.  В блоке **Размещения** выберите:
-      Вашей организации предоставлен один [публичный IP-адрес](compute-ip.md#типы-адресов). Назначьте публичный IP-адрес ВМ, создаваемой в DMZ-зоне, и получите доступ из интернета к виртуальным машинам.
-      :::
-12. В блоке **Размещения** выберите:
     - **Группа размещения**: выберите правило размещения ВМ на физическом хосте. [Группу размещения](compute-affinity.md) создайте заранее.
-13. Установите флажок **Расширенные параметры**, чтобы использовать [cloud-init](https://cloudinit.readthedocs.io/en/latest/) для настройки ВМ.
+13.  Отметьте **Расширенные параметры**, чтобы использовать [cloud-init](https://cloudinit.readthedocs.io/en/latest/) для настройки ВМ.
-14. Нажмите **Создать виртуальную машину**.
+14.  Нажмите **Создать виртуальную машину**.
 
 ВМ появится на странице сервиса **Виртуальные машины** в разделе **Виртуальные машины** в статусе `Cоздается`. Выполняется сборка виртуального ВМ, назначается [IP-адрес](compute-ip.md) и полное доменное имя (FQDN). После окончания сборки ВМ перейдет в статус `Включена`.
 
-Виртуальная машина будет создана с `root`-правами.
-
 ## Добавить диск
 
 Добавление дополнительного диска к ВМ состоит из двух шагов:

src/compute/compute-overview.md

@@ -12,22 +12,7 @@
 - тип и размер диска;
 - регион доступности.
 
-## Зоны доступности
+## Группы виртуальных машин
-
-Виртуальную машину можно создать в одной из зон доступности:
-
-- `Inside` — внутренняя зона не подразумевает доступ из интернета к виртуальным машинам.
-- `DMZ` — демилитаризованная зона подразумевает доступ из интернета к виртуальным машинам.
-
-К виртуальной машине, созданной в зоне `DMZ`, можно подключиться из интернета по SSH.
-
-Доступ из интернета к виртуальным машинам, созданным в зоне `Inside` осуществляется:
-
-- создайте ВМ в зоне `DMZ`;
-- назначьте ВM публичный IP-адрес;
-- [подключитесь к ВМ](./compute-how-to/compute-connect.md#подключиться-к-вм) `Inside`-зоны через виртуальную машину `DMZ`-зоны.
-
-## Размещение виртуальных машин
 
 Группу виртуальных машин внутри одной зоны доступности можно объединить в соответствии с определенной политикой размещения. Доступны политики:
 
@@ -39,55 +24,37 @@
 
 - Правило `Soft-Anti-Affinity` размещает ВМ по возможности на разных физических хостах.
 
-## CPU и RAM
+## Зоны доступности
 
-### Тарифы
+Виртуальную машину можно создать в одной из зон доступности:
 
-При создании виртуальной машины доступны готовые конфигурации CPU и RAM.  
+- `Inside` — закрытый контур, не подразумевает доступ из интернета к виртуальным машинам.
+- `DMZ` — демилитаризованная зона, подразумевает доступ из интернета к виртуальным машинам.
 
-| Группа      | slug        | ЦПУ | ОЗУ Гбайт |
+## Шаблоны конфигурации ВМ
-|:------------|:------------|:----|:----------|
+
-| маленькие   | cpu2ram2    | 2   | 2         |
+При создании виртуальной машины доступны готовые конфигурации CPU и RAM. Произвольные конфигурации недоступны.
-| маленькие   | cpu2ram4    | 2   | 4         |
-| маленькие   | cpu2ram8    | 2   | 8         |
-| маленькие   | cpu2ram16   | 2   | 16        |
-| маленькие   | cpu4ram4    | 4   | 4         |
-| маленькие   | cpu4ram8    | 4   | 8         |
-| маленькие   | cpu4ram16   | 4   | 16        |
-| маленькие   | cpu4ram32   | 4   | 32        |
-| средние     | cpu8ram16   | 8   | 16        |
-| средние     | cpu8ram32   | 8   | 32        |
-| средние     | cpu8ram64   | 8   | 64        |
-| средние     | cpu8ram128  | 8   | 128       |
-| средние     | cpu16ram4   | 16  | 4         |
-| средние     | cpu16ram8   | 16  | 8         |
-| средние     | cpu16ram16  | 16  | 16        |
-| средние     | cpu16ram32  | 16  | 32        |
-| средние     | cpu16ram64  | 16  | 64        |
-| средние     | cpu16ram128 | 16  | 128       |
-| большие     | cpu24ram48  | 24  | 48        |
-| большие     | cpu24ram96  | 24  | 96        |
 
 ## Диски
 
 Хранение данных организовано с использованием сетевых дисков. Диск создается в определенной зоне доступности. Каждый диск автоматически реплицируется внутри своей зоны доступности, что обеспечивает надежное хранение данных.
 
-Доступны типы дисков:
+Система хранения построена на платформе Ceph. Используются блочные устройства хранения данных — `NBD (network block device)`. Доступен тип диска — `SSD`.
-- NBD.
 
 ## Операционная система
 
-Для виртуальных машин подготовлены образы операционных систем.
+Для виртуальных машин подготовлены образы операционных систем UNIX.
 
-| Операционная система | Версия | Размер загрузочного диска | Имя пользователя |
+В операционных системах доступен `root`-пользователь. Для подключения к ВМ используется имя пользователя ОС по умолчанию.
+
+| Операционная система | Версия | Размер загрузочного диска | Имя пользователя по умолчанию |
 |---|---|---|---|
 | AstraLinux | 1.8.2 | 3 Гб | astra|
 | CentOS | 9 | 10 Гб | centos|
 | CentOS | 10 | 10 Гб | centos|
 | Debian | 12 | 5 Гб | debian|
+| Rocky Linux | 9 | 10 Гб | rocky |
 | Ubuntu | 20.04 | 5 Гб | ubuntu |
 | Ubuntu | 22.04 | 5 Гб | ubuntu |
 | VyOS | 13 | 2 Гб | vyos |
 | VyOS | 14 | 2 Гб | vyos |
-
-<!--| Rocky Linux | 9 | 10 Гб | rockylinux |-->

src/compute/index.md

@@ -4,7 +4,7 @@ section_links:
     link: /compute/compute-overview.md
     description: Обзор сервиса, решаемые задачи, характеристики оборудования
   - title: Виртуальные машины
-    link: /compute/compute-how-to/compute-Index.md
+    link: /compute/compute-how-to/compute-index.md
     description: Создание виртуальной машины и подключение к ней, управление виртуальной машиной
   - title: Диски
     link: /compute/compute-how-to/compute-disks.md

src/index.md

@@ -26,6 +26,9 @@ features:
   - title: Аккаунт Beeline Cloud
     details: Аккаунт пользователя Beeline Cloud.
     link: /admin/index
+  - title: Дизайн-платформа Yellowbe
+    details: Инструкця по работе с Yellowbe.
+    link: /yellowbe/index
  
 ---
 

src/platform/index.md

@@ -17,7 +17,7 @@ Beeline Cloud — облачная платформа, основанная на
 - быстрое развертывание сервисов;
 - безопасное хранение данных — наши системы хранения данных соответствуют строгим стандартам;
 - защита данных от утечек и несанкционированного доступа;
-- гибкое масштабирование — увеличение или уменьшение ресурсы по мере необходимости.
+- гибкое масштабирование — увеличение или уменьшение ресурсов по мере необходимости.
 - прогнозируемые расходы.
 
 Облачная платформа полностью соответствует требованиям по защите ПДн для первого уровня защищенности (УЗ-1), что позволяет безопасно размещать и обрабатывать персональные данные.

src/platform/support/support-overview.md

@@ -10,7 +10,7 @@
 
 | Способ связи | Описание | Время работы |
 |--------|----------|---------------------|
-|Портал технической поддержки| /скоро появится | круглосуточно |
+|Центр поддержки| [lk.cloud.beeline.ru/support-center](https://lk.cloud.beeline.ru/support-center) | круглосуточно |
 |Почта | [servicedesk@datafort.ru](mailto:servicedesk@datafort.ru) | круглосуточно|
 
 ## Сроки обработки запросов

src/start/trial.md

@@ -23,19 +23,25 @@
 - создание других пользователей в проекте недоступно;
 - установлены [квоты](#квоты-сервисов) на ресурсы сервисов.
 
-### Квоты сервисов
+## Квоты сервисов
 
-::: details Виртуальные дата-центры на VMware
+### Виртуальные дата-центры на VMware
 
 | Вид ограничения | Значение |
 |---|---|
 | Количество виртуальных дата-центров в проекте  | 1 |
 | Количество vCPU в одном дата-центре  | 4 |
-| Объем RAM в одном дата-центре | 8 Гб |
+| Объем RAM в одном дата-центре | 8 ГБ |
-| Объем дискового пространства в одном дата-центре | 80 Гб |
+| Объем дискового пространства в одном дата-центре | 80 ГБ |
 |Количество публичных IP-адресов в одном дата-центре| 1 |
 
-:::
+### Виртуальные машины
+
+| Вид ограничения | Значение |
+|---|---|
+|Количество публичных IP-адресов | 1 |
+|Шаблоны конфигурации vCPU и RAM виртуальных машин| 2 vCPU 2 ГБ RAM<br> 2 vCPU 4 ГБ RAM<br> |
+|Суммарный объем SSD-дисков, включая образы загрузочных дисков | 100 ГБ |
 
 ## Переход на платное использование
 

src/yellowbe/about.md

@@ -0,0 +1,22 @@
+# Из чего состоит дизайн-платформа
+
+## Ресурсы
+
+### Frontend
+
+- Компоненты на React. Реализованные в коде компоненты дизайн-платформы для фреймворка React
+- Токены компонентов. Готовые переменные всех свойств и стилей, которые при изменении дизайна автоматически обновляются в коде.
+- Мигратор. Инструмент для миграции устаревших токенов.
+
+### Дизайн
+
+- Web компоненты. Набор готовых и актуальных компонентов, которые значительно ускоряют процесс проектирования для веб-продуктов.
+- Набор базовых стилей. Обширная библиотека базовых стилей с готовыми палитрами, шрифтовой архитектурой и системой отступов.
+- Плагин icon finder. Плагин для поиска нужной иконки в иконочном шрифте Yellowbe.
+
+### Основы
+
+- Базовые токены. Набор базовых переменных (цвет, типографика, форма или свойство объекта) представленный в виде данных.
+- Иконки. Иконки Дизайн-платформы объединены в иконочный шрифт, который легко подключается к любому продукту. Шрифт имеет актуальную версию и автоматически дополняется новыми иконками.
+- Перестилизация элементов. Файлы, упрощающие глобальные настройки (подключение шрифтов, перестилизация скроллбара и т.д).
+- Гайды. Руководства по использованию инструментов дизайн-платформы.

src/yellowbe/get-started/design.md

@@ -0,0 +1,54 @@
+
+# Установка
+
+### Подготовительные действия
+- Скачайте файлы с библиотекой [Yellowbe_Trial.pix](https://yellowbe.beeline.ru/consumer/assets/files/Yellowbe_Trial.pix)
+- Импортируйте скачанный файл библиотеки в черновики (Drafts) ![Импорт библиотеки](../assets/import.png)
+
+### Подключение библиотеки Pixso
+- Если у вас бесплатный аккаунт в Figma, то вы можете работать в файле. Создавайте новые страницы и проектируйте в них, используя локальные компоненты «Yellowbe».
+- Платный (Enterprise) аккаунт даёт вам возможность опубликовать файл как библиотеку и подключать её к другим файлам. Переместите файл в команду и опубликуйте его.
+- Теперь вы можете подключить опубликованную библиотеку к файлам проекта: Component > Library > Enterprise libraries > Switch ON
+
+![Импорт библиотеки](../assets//imp.png)
+![Импорт библиотеки](../assets//on_lib.png)
+
+# Работа с компонентами
+ Компоненты — это часто повторяющиеся элементы интерфейса. Они помогают создавать и поддерживать консистентный дизайн в продуктах. Мы пытаемся покрывать все потребности дизайнеров и постоянно работаем над развитием системы. 
+
+### Принципы работы с компонентами
+При использовании библиотеки компонентов следуйте принципам:
+- Выбирать компоненты через вкладку Component
+- Не отвязывать компоненты, с целью их “доработать”
+- Не копировать мастер-компонент из библиотеки в Pixso
+
+
+### Типы компонентов
+
+- Сквозной компонент. Это компонент, который переиспользуется во всех макетах. Его стоит обернуть в локальный компонент в вашем проекте, чтобы все изменения происходили автоматически. 
+- Кастомизируемый компонент.Это компонент, который предполагает изменения под нужды продуктов. Например, добавить в Header дополнительные кнопки или иконки. 
+- Сборный компонент. Это группа компонентов-деталей, из которых собирается компонент или целый элемент интерфейса. К таким составным компонентам относятся: Autocomplete, Cell, List, Side sheet. 
+
+#### Сквозной компонент
+ Настраивается под продукт, и затем дублируется во всем проекте. Например, Navigation drawer или Header. 
+
+ Следует обернуть копию компонента из библиотеки в свой локальный компонент и дать название в соответствии со значением. 
+ При редактирование локального компонента, изменения наследуются на остальные инстансы, а связь с Дизайн-платформой сохраняется. 
+ Детачить компонент из библиотеки нельзя. 
+
+#### Кастомизируемый компонент
+ Кастомизируется под запрос продукта, но полностью соответствуют правилам дизайн-платформы и следует единому дизайну. 
+
+ Бывает что компонент не до конца соответствует запросу продукта, и в этом случае можно доработать компонент под частный случай. 
+
+ Все элементы добавляются в единый фрейм/группу, объединяющую базовый компонент Yellowbe и другие элементы. При создании такого компонента необходимо соблюдать правила дизайн-платформы и здравого смысла. 
+
+ Скрывать ненужные элементы можно через панель управления вариантами. Детачить компонент из библиотеки нельзя. 
+
+#### Сборный компонент из компонентов Yellowbe
+ Состоит из нескольких компонентов, или групп, которые помогают формировать свой уникальный элемент интерфейса.   
+ Может собираться из компонентов: list item, cell, notification, sideshit, autocomplete и др. 
+
+ Из маленьких элементов следует собирать более крупные и формирующие группы, блоки или страницы. Сборный компонент легко изменить в любом месте и любом объёме, убрав или заменив нужный элемент. 
+
+ Сборка компонента похожа на конструктор, и даёт больше гибкости в реализации. 

src/yellowbe/get-started/dev.md

@@ -0,0 +1,122 @@
+# 📦 Установка
+
+### Установка из локального архива
+Для установки библиотеки из скачанного архива выполните:
+- Скачайте архив <code>yellowbe-ui-vX.X.X.tgz</code> из <a href="https://github.com/beeline-design/yellowbe-ui/releases" target="_blank">релизов GitHub</a>
+- Переместите архив в папку вашего проекта
+- Выполните команду установки:
+
+
+```bash
+npm install ./yellowbe-ui-vX.X.X.tgz
+# или
+yarn add ./yellowbe-ui-vX.X.X.tgz
+```
+
+### 🔨 Быстрый старт
+
+```jsx
+import { ThemeProvider, Button, Input } from "@yellowbe/design-system-react";
+
+function App() {
+  return (
+    <ThemeProvider isRoot theme='light'>
+      <Input label="Email" type="email" />
+      <Button variant="primary">Отправить</Button>
+    </ThemeProvider>
+  );
+}
+```
+
+## 🎨 Настройка темизации
+
+Оберните корневой компонент приложения:
+
+```jsx
+import { ThemeProvider } from "@yellowbe/design-system-react";
+
+function RootComponent() {
+  return (
+    <ThemeProvider isRoot theme='light'>  {/* или 'dark' */}
+      <App />
+    </ThemeProvider>
+  );
+}
+```
+
+## 🔤 Подключение шрифтов и стилей
+
+### Шрифт Roboto
+Библиотека использует шрифт **Roboto** от Google, распространяемый под лицензией **Apache License 2.0**:
+
+- [Лицензия Roboto](https://github.com/google/roboto/blob/main/LICENSE)
+- [Официальный сайт шрифта](https://fonts.google.com/specimen/Roboto)
+
+**Условия использования:**
+✅ Разрешено:
+- Бесплатное использование в коммерческих и некоммерческих проектах
+- Модификация шрифта
+- Распространение в продуктах
+
+### Для полной интеграции дизайн-платформы добавьте:
+
+#### В глобальном CSS/SCSS
+```css
+@import '~@yellowbe/design-tokens/css/iconfont/iconfont.css';
+@import '~@yellowbe/design-tokens/css/font-face.css';
+@import '~@yellowbe/design-tokens/css/scrollbar.css';
+```
+#### Или через JS:
+
+```js
+// В корневом JS/TS файле
+import '@yellowbe/design-tokens/css/iconfont/iconfont.css';
+import '@yellowbe/design-tokens/css/font-face.css';
+import '@yellowbe/design-tokens/css/scrollbar.css';
+```
+
+#### После подключения:
+
+- Доступен шрифт "Roboto" (автоматически используется в Typography)
+- Работает иконочный шрифт "Yellowbe Icons" (для компонента Icon)
+- Скроллбар с поддержкой темизации (Chromium/Firefox)
+
+**Для работы компонента Icon необходимо подключить шрифт иконок**
+
+## ⚠️ Внимание: При проблемах со сборкой:
+
+- Проверьте настройки сборщика для обработки CSS и шрифтов
+- Убедитесь что пакет @yellowbe/design-tokens установлен
+- Обратитесь к документации 
+
+## 🧩 Использование компонентов
+Библиотека поддерживает оба формата импорта:
+
+### ESM (рекомендуется)
+```jsx
+import { Button, Typography, Icon } from '@yellowbe/design-system-react';
+
+function Component() {
+  return (
+    <>
+      <Button variant="primary">Действие</Button>
+      <Typography variant="h1">Заголовок</Typography>
+      <Icon name="arrow-right" size={24} />
+    </>
+  );
+}
+```
+
+### CommonJS
+```jsx
+const { Button, Typography } = require('@yellowbe/design-system-react');
+
+function Component() {
+  return (
+    <>
+      <Button>Кнопка</Button>
+      <Typography>Текст</Typography>
+    </>
+  );
+}
+```

src/yellowbe/get-started/index.md

@@ -0,0 +1,13 @@
+---
+section_links:
+  - title: Для разработчика
+    link: /yellowbe/get-started/dev.md
+    description: Как начать работу с библиотеками Yellowbe
+  - title: Для дизайнера
+    link: /yellowbe/get-started/design.md
+    description:  Как начать работу с библиотеками Yellowbe
+---    
+
+# Начать работу
+
+Как бастро начать использовать дизайн-платформу

src/yellowbe/index.md

@@ -0,0 +1,45 @@
+---
+section_links:
+  - title: Начать работу
+    link: /yellowbe/get-started/index.md
+    description: Как начать работу с библиотеками Yellowbe
+  - title: Из чего состоит дизайн-платформа
+    link: /yellowbe/about.md
+    description: Список компонентов Yellowbe
+---    
+
+# Дизайн-платформа Yellowbe
+
+Готовые UI компоненты для разработчиков и дизайнеров, без санкций и ограничений с поддержкой темизации. 
+
+Дизайн-платформа Yellowbe входит в Реестр российского ПО, [Реестровая запись №27198 от 19.03.2025](https://reestr.digital.gov.ru/reestr/3166609/)
+
+
+## Ссылки на ресурсы
+
+<div class="cards-container" style="display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 20px; margin: 30px 0;">
+
+<div class="card" style="border: 1px solid #e1e4e8; border-radius: 10px; padding: 20px; box-shadow: 0 3px 10px rgba(0,0,0,0.08);display:flex; flex-direction:column">
+    <h3 style="margin-top: 0;">📚 Официальная документация</h3>
+    <p style="margin:auto">Полное руководство по использованию компонентов, API и примеры кода</p>
+    <a href="https://yellowbe.beeline.ru/consumer/main" style="display: inline-block; background: #f0f4f8; color: #0366d6; padding: 8px 15px; border-radius: 6px; text-decoration: none; font-weight: 500; margin-top: 10px;">
+        Перейти к документации →
+    </a>
+</div>
+
+<div class="card" style="border: 1px solid #e1e4e8; border-radius: 10px; padding: 20px; box-shadow: 0 3px 10px rgba(0,0,0,0.08); display:flex; flex-direction:column">
+    <h3 style="margin-top: 0;">🎨 Pixso</h3>
+    <p style="margin:auto">Файлы библиотеки компонентов для Pixso</p>
+    <a href="https://yellowbe.beeline.ru/consumer/get-started/design/pixso-components" style="display: inline-block; background: #f0f4f8; color: #0366d6; padding: 8px 15px; border-radius: 6px; text-decoration: none; font-weight: 500; margin-top: 10px;">
+        Перейти к установке →
+    </a>
+</div>
+
+<div class="card" style="border: 1px solid #e1e4e8; border-radius: 10px; padding: 20px; box-shadow: 0 3px 10px rgba(0,0,0,0.08);display:flex; flex-direction:column">
+    <h3 style="margin-top: 0;">💬 Вопросы</h3>
+    <p style="margin:auto">По вопросам можно обращаться на почту</p>
+    <a href="mailto:designsystem@beeline.ru&subject=Обращение из GitHub" style="display: inline-block; background: #f0f4f8; color: #0366d6; padding: 8px 15px; border-radius: 6px; text-decoration: none; font-weight: 500; margin-top: 10px;">
+        Написать нам →
+    </a>
+</div>
+</div>