> For the complete documentation index, see [llms.txt](https://hacking-notes.jord4n.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hacking-notes.jord4n.pro/ru/useful-resources/gh0stzk-bspwm-dotfiles.md).

# Настройка Arch Linux для хакера с BSPWM

[gh0stzk/dotfiles](https://github.com/gh0stzk/dotfiles) — это полноценное BSPWM-окружение рабочего стола для Arch Linux и дистрибутивов на базе Arch. Оно включает темы, панели, лаунчеры, настройки терминала, ZSH, апплеты Neovim и Rofi, обои и вспомогательные скрипты для быстрого переключения стилей.

<figure><img src="https://user-images.githubusercontent.com/67278339/221605474-21d65156-0cf7-485c-bd1a-40792c37817e.png" alt="gh0stzk BSPWM dotfiles desktop screenshot with terminal and Linux fetch output"><figcaption><p>Пример BSPWM-окружения рабочего стола из README проекта.</p></figcaption></figure>

{% hint style="warning" %}
Устанавливайте это только на личной лабораторной машине или на свежей Linux-рабочей станции. Dotfiles заменяют многие пользовательские конфигурационные файлы, поэтому перед запуском проверьте установщик и сделайте резервную копию текущей системы.
{% endhint %}

## Где это уместно

Это относится к `Полезные ресурсы` потому что это ресурс для настройки рабочей станции, а не инструмент для пентестинга. Используйте его, когда вам нужно чистое BSPWM-окружение на базе Arch для ежедневных заметок, лабораторных работ, CTF, разработки и рабочих процессов с интенсивным использованием терминала.

## Что вы получите

| Компонент     | Что это значит                                                                                                   |
| ------------- | ---------------------------------------------------------------------------------------------------------------- |
| BSPWM         | Плиточный оконный менеджер для быстрого рабочего стола, управляемого с клавиатуры.                               |
| 18 тем        | Готовые визуальные стили, которые можно переключать на лету.                                                     |
| Polybar       | Панель рабочего стола с рабочими пространствами, модулями, системной информацией и цветами темы.                 |
| Апплеты Rofi  | Меню для приложений, питания, скриншотов, буфера обмена, сети, Bluetooth, обоев и многого другого.               |
| Терминалы     | Поддержка тем для Alacritty, Kitty, Ghostty, ST и Xfce Terminal.                                                 |
| Конфиг ZSH    | Быстрая настройка оболочки с автодополнением, поиском по истории и предварительным просмотром fzf-tab.           |
| Конфиг Neovim | Готовая настройка редактора с LSP, автодополнением, форматированием, обозревателем, статусной строкой и панелью. |
| RiceEditor    | Вспомогательное приложение для настройки визуальных параметров без ручного редактирования каждого конфига.       |

## Визуальный предварительный просмотр

Проект очень визуальный, поэтому перед установкой посмотрите скриншоты и демонстрацию.

<figure><img src="https://github.com/gh0stzk/dotfiles/assets/67278339/b11b5c58-b9ec-446b-8980-4f77bebb3432" alt="gh0stzk dotfiles theme selector screenshot"><figcaption><p>Селектор темы.</p></figcaption></figure>

<figure><img src="https://github.com/user-attachments/assets/dbac8c47-f12c-4242-97d6-38ad1193f76b" alt="gh0stzk dotfiles wallpaper selector screenshot"><figcaption><p>Селектор обоев.</p></figcaption></figure>

<figure><img src="https://github.com/user-attachments/assets/2ac910c8-171f-47eb-8210-1469b6f75cc2" alt="gh0stzk dotfiles RiceEditor screenshot"><figcaption><p>RiceEditor для настройки темы.</p></figcaption></figure>

### Демонстрация проекта

{% embed url="<https://github.com/user-attachments/assets/3eaae1e2-04dc-4a9b-8c91-139f85f5fb9e>" %}

### Пошаговое руководство по установке Arch

Это видео автора полезно, если вы хотите чистую установку Arch перед применением dotfiles.

{% embed url="<https://www.youtube.com/watch?v=mspY7Mpmcug>" %}

### Канал проекта

На канале автора есть ещё больше демонстраций BSPWM, Polybar, Eww, Rofi и тем.

{% embed url="<https://www.youtube.com/@gh0stzk-dotfiles>" %}

## Перед установкой

Официальный установщик предназначен для Arch Linux и дистрибутивов на базе Arch. В README указано, что дистрибутивы без systemd, такие как Artix, не поддерживаются.

Рекомендуемая отправная точка:

| Требование                              | Примечания                                                  |
| --------------------------------------- | ----------------------------------------------------------- |
| Дистрибутив Arch или на базе Arch       | Самый безопасный вариант — чистая установка.                |
| Обычная пользовательская учётная запись | Не запускайте установщик от root.                           |
| Рабочий интернет                        | Установщик загружает пакеты и репозитории.                  |
| Менеджер входа                          | Проект рекомендует LightDM.                                 |
| NetworkManager                          | Нужен для апплета сети в Rofi.                              |
| Резервная копия                         | Сохраните копию существующих `~/.config` и файлов оболочки. |

Полезная команда для резервного копирования перед тестированием:

```bash
mkdir -p "$HOME/dotfiles-backup"
cp -a "$HOME/.config" "$HOME/dotfiles-backup/config-$(date +%F)" 2>/dev/null
cp -a "$HOME/.zshrc" "$HOME/.gtkrc-2.0" "$HOME/.icons" "$HOME/dotfiles-backup/" 2>/dev/null
```

## Быстрая настройка Arch

Используйте это, если вы начинаете с чистой машины Arch или VM и хотите максимально короткий практический путь.

### 1. Загрузитесь с Arch ISO

Начните с официального Arch ISO. Если вы используете Wi‑Fi, сначала подключитесь:

```bash
iwctl
```

Внутри `iwctl`:

```
список устройств
station wlan0 scan
station wlan0 get-networks
station wlan0 connect "SSID"
exit
```

Проверьте интернет:

```bash
ping -c 3 archlinux.org
```

Синхронизируйте время:

```bash
timedatectl set-ntp true
```

### 2. Быстро установите Arch

Быстрый путь — `archinstall`:

```bash
archinstall
```

Рекомендуемые варианты:

| Параметр              | Выберите                                                                     |
| --------------------- | ---------------------------------------------------------------------------- |
| Разметка диска        | По умолчанию или вручную, в зависимости от вашей VM/диска.                   |
| Загрузчик             | `systemd-boot` для UEFI, GRUB — если предпочитаете его.                      |
| Профиль               | Минимального достаточно; рабочий стол необязателен.                          |
| Сеть                  | NetworkManager.                                                              |
| Аудио                 | PipeWire.                                                                    |
| Пользователь          | Создайте обычного пользователя с доступом sudo.                              |
| Дополнительные пакеты | `git curl base-devel xorg-server lightdm lightdm-gtk-greeter networkmanager` |

После установки:

```bash
перезагрузитесь
```

### 3. Включите базовые компоненты

Войдите как обычный пользователь, затем убедитесь, что базовые службы готовы:

```bash
sudo pacman -Syu
sudo pacman -S --needed git curl base-devel xorg-server lightdm lightdm-gtk-greeter networkmanager
sudo systemctl enable --now NetworkManager
sudo systemctl enable lightdm
```

Ещё раз перезагрузитесь, если вы только что включили LightDM:

```bash
sudo reboot
```

## Установка dotfiles

Откройте терминал из домашнего каталога:

```bash
cd "$HOME"
```

Скачайте официальный установщик:

```bash
curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller
```

Проверьте установщик перед запуском:

```bash
less RiceInstaller
```

Дайте ему право на выполнение:

```bash
chmod +x RiceInstaller
```

Запустите его как обычный пользователь:

```bash
./RiceInstaller
```

Установщик интерактивный. Он может спросить, нужны ли вам включённые конфигурации Neovim и Firefox. Читайте каждый запрос, а не просто нажимайте Enter везде подряд.

### Установка одним блоком

Для быстрой установки в лаборатории, когда у вас уже есть рабочий Arch:

```bash
cd "$HOME"
curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller
less RiceInstaller
chmod +x RiceInstaller
./RiceInstaller
```

## Что делает установщик

На высоком уровне установщик:

1. Проверяет, что он не запущен от root.
2. Проверяет, что он запускается из `$HOME`.
3. Добавляет репозиторий пакетов `gh0stzk-dotfiles` .
4. Добавляет Chaotic-AUR.
5. Скачивает dotfiles.
6. Создаёт резервные копии существующих пользовательских конфигов, где это нужно.
7. Устанавливает окружение BSPWM.
8. Включает MPD для музыкальных функций.
9. Меняет оболочку на ZSH.

Скрипт также переносит многие существующие папки конфигурации в каталог резервных копий перед заменой. Тем не менее сначала сделайте свою собственную копию.

## Первый вход

После установки:

1. Перезагрузитесь или выйдите из системы.
2. Выберите сеанс BSPWM в вашем менеджере входа.
3. Войдите как обычно.
4. Дождитесь завершения автоконфигурации при первом запуске.
5. Проверьте терминал, Rofi, Polybar, селектор темы и селектор обоев.

Если вы находитесь в виртуальной машине и рабочий стол кажется сломанным или медленным, попробуйте сменить Picom с `glx` на `xrender` прежде чем считать, что установка не удалась.

## Что проверить в первую очередь

После первого запуска проверьте переменные, связанные с оборудованием. Откройте:

```bash
~/.config/bspwm/config/system.ini
```

Проверьте значения для:

| Значение          | Почему это важно                                |
| ----------------- | ----------------------------------------------- |
| Сетевой интерфейс | Сетевые модули на панели.                       |
| Видеокарта        | Некоторые визуальные модули и модули состояния. |
| Батарея и адаптер | Модули батареи ноутбука и яркости.              |

Если у вас настольный ПК, сетевой интерфейс обычно является главным, о котором стоит позаботиться.

## Полезные команды

| Команда                             | Используйте                                                               |
| ----------------------------------- | ------------------------------------------------------------------------- |
| `RiceSelector`                      | Открыть селектор темы.                                                    |
| `RiceEditor`                        | Визуально отредактировать текущую тему.                                   |
| `WallSelect`                        | Открыть селектор обоев.                                                   |
| `Term --selecterm`                  | Выбрать приложение-терминал.                                              |
| `OpenApps --menu`                   | Открыть лаунчер приложений.                                               |
| `OpenApps --KeyHelp`                | Открыть шпаргалку по горячим клавишам.                                    |
| `OpenApps --screenshot`             | Открыть инструмент для скриншотов.                                        |
| `OpenApps --netmanager`             | Открыть апплет сетевого менеджера.                                        |
| `OpenApps --bluetooth`              | Открыть апплет Bluetooth.                                                 |
| `OpenApps --clipboard`              | Открыть менеджер буфера обмена.                                           |
| `OpenApps --powermenu`              | Открыть меню питания.                                                     |
| `OpenApps --keyboard`               | Открыть апплет раскладки клавиатуры.                                      |
| `OpenApps --scratch`                | Открыть scratchpad.                                                       |
| `HideBar -h`                        | Скрыть панели.                                                            |
| `HideBar -u`                        | Показать панели.                                                          |
| `SoftReload`                        | Мягко перезагрузить окружение.                                            |
| `ScreenLocker`                      | Заблокировать экран.                                                      |
| `bspc wm -r`                        | Перезагрузить BSPWM.                                                      |
| `pkill -USR1 -x sxhkd`              | Перезагрузить привязки клавиш.                                            |
| `~/.config/bspwm/config/system.ini` | Переменные оборудования/модулей, которые нужно проверить после установки. |
| `~/.config/bspwm/config/sxhkdrc`    | Основной файл привязок клавиш.                                            |

## Полные привязки клавиш

Проект показывает визуальную шпаргалку с `Alt + F1`. `Super` означает клавишу Windows на большинстве клавиатур. Источником истины является установленный `~/.config/bspwm/config/sxhkdrc`; эта таблица следует текущему upstream-файлу и группирует все сочетания, чтобы их было легче просматривать.

### Справка

| Клавиши    | Действие                                |
| ---------- | --------------------------------------- |
| `Alt + F1` | Показать шпаргалку по горячим клавишам. |

### Основные приложения

| Клавиши                | Действие                           |
| ---------------------- | ---------------------------------- |
| `Super + Return`       | Открыть обычный терминал.          |
| `Super + Alt + Return` | Открыть плавающий терминал.        |
| `Super + Space`        | Открыть лаунчер приложений.        |
| `Alt + Space`          | Открыть селектор темы.             |
| `Super + B`            | Открыть браузер.                   |
| `Super + E`            | Открыть редактор.                  |
| `Super + F`            | Открыть файловый менеджер.         |
| `Super + Y`            | Открыть Yazi.                      |
| `Super + V`            | Открыть Neovim.                    |
| `Super + M`            | Открыть музыкальный плеер/Ncmpcpp. |
| `Super + P`            | Открыть Pavucontrol.               |
| `Super + T`            | Открыть Telegram.                  |
| `Super + W`            | Открыть WhatsApp.                  |
| `Super + R`            | Открыть RiceEditor.                |

### Апплеты Rofi

| Клавиши                                          | Действие                      |
| ------------------------------------------------ | ----------------------------- |
| `Super + Alt + T`                                | Селектор терминала.           |
| `Super + Alt + W`                                | Селектор обоев.               |
| `Super + Alt + A`                                | Апплет монтирования Android.  |
| `Super + Alt + N`                                | Менеджер сети.                |
| `Super + Alt + B`                                | Менеджер Bluetooth.           |
| `Super + Alt + C`                                | Менеджер буфера обмена.       |
| `Super + Alt + S`                                | Инструмент для скриншотов.    |
| `Super + Alt + P`                                | Меню питания.                 |
| `Super + Alt + L`                                | Селектор стиля лаунчера Rofi. |
| `Super + Alt + K`                                | Апплет раскладки клавиатуры.  |
| `Super + Alt + X`                                | RofiPass/апплет паролей.      |
| `Щёлкните правой кнопкой мыши по рабочему столу` | Открыть Jgmenu.               |

### Система и окружение

| Клавиши                  | Действие                                 |
| ------------------------ | ---------------------------------------- |
| `Super + Alt + O`        | Scratchpad.                              |
| `Ctrl + Super + Alt + P` | Выключить компьютер.                     |
| `Ctrl + Super + Alt + R` | Перезагрузить компьютер.                 |
| `Ctrl + Super + Alt + Q` | Выйти из системы.                        |
| `Ctrl + Super + Alt + L` | Заблокировать экран.                     |
| `Ctrl + Super + Alt + K` | Завершить приложение с помощью `xkill`.  |
| `Ctrl + Super + Alt + S` | Мягкая перезагрузка.                     |
| `Super + Alt + H`        | Скрыть панель.                           |
| `Super + Alt + U`        | Показать панель.                         |
| `Ctrl + Alt + Plus`      | Увеличить прозрачность у активного окна. |
| `Ctrl + Alt + Minus`     | Уменьшить прозрачность у активного окна. |
| `Ctrl + Alt + T`         | Сбросить прозрачность у активного окна.  |
| `XF86MonBrightnessUp`    | Увеличить яркость.                       |
| `XF86MonBrightnessDown`  | Уменьшить яркость.                       |
| `XF86AudioRaiseVolume`   | Увеличить громкость.                     |
| `XF86AudioLowerVolume`   | Уменьшить громкость.                     |
| `XF86AudioMute`          | Переключить звук без звука.              |
| `XF86AudioNext`          | Следующий медиа-трек.                    |
| `XF86AudioPrev`          | Предыдущий медиа-трек.                   |
| `XF86AudioPlay`          | Воспроизведение/пауза медиа.             |
| `XF86AudioStop`          | Остановить воспроизведение.              |

### Ядро BSPWM

| Клавиши             | Действие                             |
| ------------------- | ------------------------------------ |
| `Super + Alt + R`   | Перезагрузить BSPWM.                 |
| `Super + X`         | Закрыть сфокусированный узел.        |
| `Super + Shift + X` | Завершить сфокусированный узел.      |
| `Super + Escape`    | Перезагрузить привязки клавиш sxhkd. |

### Состояния и флаги узлов

| Клавиши           | Действие                                       |
| ----------------- | ---------------------------------------------- |
| `Alt + T`         | Установить узел плиточным.                     |
| `Alt + Shift + T` | Установить узел псевдоплиточным.               |
| `Alt + A`         | Установить узел плавающим.                     |
| `Alt + F`         | Установить узел полноэкранным.                 |
| `Alt + M`         | Переключить флаг пометки.                      |
| `Alt + X`         | Переключить флаг блокировки.                   |
| `Alt + S`         | Переключить липкий флаг.                       |
| `Alt + P`         | Переключить приватный флаг.                    |
| `Alt + H`         | Скрыть сфокусированное окно.                   |
| `Ctrl + Alt + H`  | Показать меню для восстановления скрытых окон. |

### Рабочие пространства и фокус

| Клавиши                                  | Действие                                                                            |
| ---------------------------------------- | ----------------------------------------------------------------------------------- |
| `Ctrl + Tab`                             | Повернуть рабочий стол.                                                             |
| `Super + Left`                           | Переключиться на предыдущее рабочее пространство.                                   |
| `Super + Right`                          | Переключиться на следующее рабочее пространство.                                    |
| `Super + 1` на `Super + 9`               | Сфокусировать рабочие пространства 1–9.                                             |
| `Super + 0`                              | Сфокусировать рабочее пространство 10.                                              |
| `Super + Ctrl + 1` на `Super + Ctrl + 9` | Отправить сфокусированное окно в рабочее пространство 1–9.                          |
| `Super + Ctrl + 0`                       | Отправить сфокусированное окно в рабочее пространство 10.                           |
| `Super + Ctrl + Left`                    | Отправить сфокусированное окно на предыдущее рабочее пространство и перейти за ним. |
| `Super + Ctrl + Right`                   | Отправить сфокусированное окно на следующее рабочее пространство и перейти за ним.  |
| `Alt + Tab`                              | Переключатель окон.                                                                 |
| `Super + Alt + Left`                     | Сфокусировать окно на запад, с запасным переходом на предыдущее.                    |
| `Super + Alt + Down`                     | Сфокусировать окно на юг.                                                           |
| `Super + Alt + Up`                       | Сфокусировать окно на север.                                                        |
| `Super + Alt + Right`                    | Сфокусировать окно на восток, с запасным переходом на следующее.                    |
| `Ctrl + Alt + Left`                      | Поменять местами сфокусированное окно с окном слева.                                |
| `Ctrl + Alt + Down`                      | Поменять местами сфокусированное окно с окном снизу.                                |
| `Ctrl + Alt + Up`                        | Поменять местами сфокусированное окно с окном сверху.                               |
| `Ctrl + Alt + Right`                     | Поменять местами сфокусированное окно с окном справа.                               |
| `Ctrl + Shift + Comma`                   | Сфокусировать последний узел.                                                       |
| `Ctrl + Shift + Period`                  | Сфокусировать последний рабочий стол.                                               |

### Предварительный выбор

| Клавиши            | Действие                                                    |
| ------------------ | ----------------------------------------------------------- |
| `Super + Ctrl + H` | Предварительно выбрать горизонтальное/восточное разделение. |
| `Super + Ctrl + V` | Предварительно выбрать вертикальное/южное разделение.       |
| `Super + Ctrl + Q` | Отменить предварительный выбор.                             |

### Перемещение и изменение размера

| Клавиши                 | Действие                            |
| ----------------------- | ----------------------------------- |
| `Super + Ctrl + B`      | Сбалансировать узлы рабочего стола. |
| `Super + Alt + Plus`    | Увеличить размер плиточного узла.   |
| `Super + Alt + Minus`   | Уменьшить размер плиточного узла.   |
| `Super + Ctrl + Plus`   | Увеличить размер плавающего узла.   |
| `Super + Ctrl + Minus`  | Уменьшить размер плавающего узла.   |
| `Super + Shift + Left`  | Переместить плавающее окно влево.   |
| `Super + Shift + Down`  | Переместить плавающее окно вниз.    |
| `Super + Shift + Up`    | Переместить плавающее окно вверх.   |
| `Super + Shift + Right` | Переместить плавающее окно вправо.  |

### Множественная операция

| Клавиши                       | Действие                                                            |
| ----------------------------- | ------------------------------------------------------------------- |
| `Super + Ctrl + X`            | Закрыть все узлы на текущем рабочем столе.                          |
| `Super + N`, затем `X`        | Закрыть все нефокусированные локальные окна.                        |
| `Super + N`, затем `K`        | Завершить все нефокусированные локальные окна.                      |
| `Super + N`, затем `M`        | Переместить все помеченные окна на сфокусированный рабочий стол.    |
| `Super + N`, затем `1` на `9` | Переместить все окна с того рабочего стола на текущий рабочий стол. |

## Общая настройка

### Изменить тему

Используйте:

```
Alt + Space
```

Выберите тему в селекторе. Среда обновится без необходимости перезапускать всю сессию.

### Изменить обои

Используйте:

```
Super + Alt + W
```

Проект поддерживает случайные обои, пользовательские каталоги, фиксированные обои, анимированные обои и поведение слайд-шоу.

### Редактировать текущую тему

Используйте RiceEditor, когда хотите настроить визуальные параметры, не редактируя вручную каждый модуль:

```
RiceEditor
```

Обычно редактируют границы, тени, анимации, прозрачность, поведение обоев и настройки модулей, специфичные для темы.

## Устранение неполадок

| Проблема                                           | Что проверить                                                                                  |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Вход возвращает к диспетчеру отображения           | Убедитесь, что сеанс BSPWM установлен, и проверьте `~/.xsession-errors`.                       |
| Модули панели отображаются неправильно             | Проверьте `~/.config/bspwm/config/system.ini`.                                                 |
| Сетевой апплет не работает                         | Убедитесь, что NetworkManager установлен и запущен.                                            |
| Графика в виртуальной машине выглядит повреждённой | Попробуйте Picom `xrender` бэкенд вместо `glx`.                                                |
| Комбинации клавиш не работают                      | Проверьте `sxhkd` запущен и проверьте `~/.config/bspwm/config/sxhkdrc`.                        |
| Тема выглядит смещённой                            | Проект рассчитан на 1600x900 и 96 DPI; подстройте под ваш монитор.                             |
| Существующие конфигурации исчезли                  | Проверьте папку резервных копий, созданную установщиком, и вашу собственную `dotfiles-backup`. |

## Примечания по чистой переустановке

Для максимально безопасной повторной попытки:

1. Сделайте резервную копию текущих файлов.
2. Удалите или переместите старые каталоги dotfiles.
3. Скачайте заново последнюю `RiceInstaller`.
4. Ещё раз просмотрите скрипт.
5. Запустите его из `$HOME` от имени обычного пользователя.

Не запускайте случайные модифицированные установщики из сторонних форков, если вы не просмотрели diff.

## Ссылки

* [Официальный репозиторий gh0stzk/dotfiles](https://github.com/gh0stzk/dotfiles)
* [RiceInstaller](https://github.com/gh0stzk/dotfiles/blob/master/RiceInstaller)
* [Первые шаги после установки](https://github.com/gh0stzk/dotfiles/wiki/First-steps-after-installation)
* [Вики по сочетаниям клавиш](https://github.com/gh0stzk/dotfiles/wiki/Keyboard-Shortcuts)
* [Текущий файл привязок клавиш sxhkdrc](https://github.com/gh0stzk/dotfiles/blob/master/config/bspwm/config/sxhkdrc)
* [Вики по настройке обоев](https://github.com/gh0stzk/dotfiles/wiki/Wallpapers-Configuration)
* [ArchWiki: bspwm](https://wiki.archlinux.org/title/Bspwm)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://hacking-notes.jord4n.pro/ru/useful-resources/gh0stzk-bspwm-dotfiles.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.