From efe1ad7c36a3f98765f70303d73a144f50d28880 Mon Sep 17 00:00:00 2001 From: Rocky Linux Automation <75949597+rockylinux-auto@users.noreply.github.com> Date: Tue, 28 Jan 2025 09:53:58 -0500 Subject: [PATCH] New Crowdin updates (#2589) * New translations installing_nvidia_gpu_drivers.md (French) * New translations flatpak.md (German) * New translations installing_nvidia_gpu_drivers.md (German) * New translations 09-backups.md (Chinese Simplified) * New translations 09-backups.md (Ukrainian) * New translations wordpress-on-lamp.md (Ukrainian) * New translations installing_nvidia_gpu_drivers.md (Ukrainian) * New translations index.md (Ukrainian) * New translations 01-gh_cli_1st_pr.md (German) * New translations 09-backups.md (Ukrainian) --- docs/books/admin_guide/09-backups.uk.md | 87 +- docs/books/admin_guide/09-backups.zh.md | 901 ++++++++++-------- .../installing_nvidia_gpu_drivers.de.md | 2 + .../installing_nvidia_gpu_drivers.fr.md | 2 + .../installing_nvidia_gpu_drivers.uk.md | 2 + docs/desktop/gnome/flatpak.de.md | 2 +- docs/gemstones/git/01-gh_cli_1st_pr.de.md | 89 ++ docs/guides/cms/wordpress-on-lamp.uk.md | 2 +- docs/rocky_insights/blogs/index.uk.md | 37 + 9 files changed, 672 insertions(+), 452 deletions(-) create mode 100644 docs/gemstones/git/01-gh_cli_1st_pr.de.md create mode 100644 docs/rocky_insights/blogs/index.uk.md diff --git a/docs/books/admin_guide/09-backups.uk.md b/docs/books/admin_guide/09-backups.uk.md index d23cbe9810..df4ab2140b 100644 --- a/docs/books/admin_guide/09-backups.uk.md +++ b/docs/books/admin_guide/09-backups.uk.md @@ -553,26 +553,40 @@ tar xvf backup.tar --wildcards '*.conf' На відміну від команди `tar`, тут немає параметрів резервного копіювання та стиснення одночасно. Отже, це робиться в два етапи: резервне копіювання та стиснення. -Щоб виконати резервне копіювання за допомогою `cpio`, вам потрібно вказати список файлів для резервного копіювання. +`cpio` має три режими роботи, кожен з яких відповідає окремій функції: -Цей список надається за допомогою команд `find`, `ls` або `cat`. +1. **режим копіювання copy-out** – створює резервну копію (архів). Ви можете ввімкнути цей режим за допомогою параметрів `-o` або `--create`. У цьому режимі ви повинні створити список файлів за допомогою певної команди (`find`, `ls` або `cat`) і передати його в cpio. -* `find` : переглянути дерево, рекурсивне чи ні; -* `ls` : перелічує каталог, рекурсивний чи ні; -* `cat` : читає файл, що містить дерева або файли, які потрібно зберегти. + * `find`: переглядає дерево, рекурсивне чи ні; + * `ls`: перелічує каталог, рекурсивний чи ні; + * `cat`: читає файл, що містить дерева або файли, які потрібно зберегти. -!!! Note "Примітка" + !!! Note "Примітка" - `ls` не можна використовувати з `-l` (подробиці) або `-R` (рекурсивний). - - Для цього потрібен простий список імен. + `ls` не можна використовувати з `-l` (деталі) або `-R` (рекурсивно). + + Для цього потрібен простий список імен. + +2. **режим копіювання copy-in** – витягує файли з архіву. Ви можете ввімкнути цей режим за допомогою параметра `-i`. +3. **режим копіювання copy-pass** – копіює файли з одного каталогу в інший. Ви можете ввімкнути цей режим за допомогою параметрів `-p` або `--pass-through`. + +Подібно до команди `tar`, користувачі мають звернути увагу на те, як зберігається список файлів (**абсолютний шлях** або **відносний шлях**) під час створення архіву. + +вторинна функція: -### Створення резервної копії за допомогою команди `cpio` +1. `-t` - Друкує зміст введених даних. +2. `-A` - Додає до існуючого архіву. Працює лише в режимі копіювання copy-in. + +!!! note "Примітка" + + Для правильної роботи деякі параметри `cpio` потрібно поєднати з правильним режимом роботи. Дивись `man 1 cpio` + +### Режим copy-out Синтаксис команди `cpio`: ```bash -[files command |] cpio {-o| --create} [-options] [device] +[files command |] cpio {-o| --create} [-options] [< file-list] [> device] ``` Приклад: @@ -589,17 +603,17 @@ find /etc | cpio -ov > /backups/etc.cpio find /etc | cpio -ovF /backups/etc.cpio ``` -Результат виконання команди `find` надсилається як вхідні дані для команди `cpio` через *pipe* (символ `|`, ++alt-graph+6++). +Результат виконання команди `find` надсилається як вхідні дані для команди `cpio` через *pipe* (символ `|`, + +зсув вліво+зворотна коса риска++). Тут команда `find /etc` повертає команді `cpio` список файлів, що відповідають вмісту каталогу `/etc` (рекурсивно), який виконує резервне копіювання. Не забудьте про знак `>` під час збереження або `F save_name_cpio`. -| Опції | Опис | -| ----- | -------------------------------------------------------- | -| `-o` | Створює резервну копію (*output*). | -| `-v` | Відображає назву оброблених файлів. | -| `-F` | Позначає резервну копію, яку потрібно змінити (середня). | +| Опції | Опис | +| ----- | ------------------------------------------------------------------------------------------------------------------------- | +| `-o` | Створює резервну копію в режимі _cp-out_. | +| `-v` | Відображає назву оброблених файлів. | +| `-F` | Резервне копіювання на певний носій, який може замінити стандартний ввід ("<") і стандартний вихід (">") у команді `cpio` | Резервне копіювання на носій: @@ -612,17 +626,13 @@ find /etc | cpio -ov > /dev/rmt0 * стрічковий накопичувач: `/dev/rmt0`; * розділ: `/dev/sda5`, `/dev/hda5` тощо. -### Тип резервного копіювання - -#### Резервне копіювання з відносним шляхом +#### Відносний і абсолютний шлях до списку файлів ```bash cd / find etc | cpio -o > /backups/etc.cpio ``` -#### Резервне копіювання з абсолютним шляхом - ```bash find /etc | cpio -o > /backups/etc.A.cpio ``` @@ -633,10 +643,10 @@ find /etc | cpio -o > /backups/etc.A.cpio Якщо шлях, указаний у команді `find`, є **відносним**, тоді резервне копіювання буде виконано у **відносному**. -### Додати до резервної копії +#### Додавання файлів до існуючих резервних копій ```bash -[files command |] cpio {-o| --create} -A [-options] [device} +[files command |] cpio {-o| --create} -A [-options] [< fic-list] {F| > device} ``` Приклад: @@ -649,10 +659,10 @@ find /etc/shadow | cpio -o -AF SystemFiles.A.cpio | Опція | Опис | | ----- | --------------------------------------------------------- | -| `-A` | Додає один або кілька файлів до резервної копії на диску. | +| `-A` | Додає один або кілька файлів до існуючої резервної копії. | | `-F` | Визначає резервну копію, яку потрібно змінити. | -### Стиснення резервної копії +#### Стиснення резервної копії * Збережіть **потім** стисніть @@ -680,13 +690,13 @@ find /etc | cpio –o | gzip > /backups/etc.A.cpio.gz Синтаксис команди `cpio` для читання вмісту резервної копії *cpio*: ```bash -cpio -t [-options] [device] -``` + 它需要一个简单的名称列表。 -Example: +2. **copy-in 模式** – 从归档中提取文件。 您可以通过 `-i` 选项启用此模式。 +3. **copy-pass 模式** - 将文件从一个目录复制到另一个目录。 您可以通过 `-p` 或 `--pass-through` 选项启用此模式。 -With a redirection of the output of `cpio`: +与 `tar` 命令一样，用户在创建归档时需要注意文件列表的保存方式（**绝对路径** 或 **相对路径**）。 -``` -$ find /etc | cpio -ov > /backups/etc.cpio -``` +次要功能： -Using the name of a backup media : +1. `-t` - 打印输入的内容表。 +2. `-A` - 追加到现有归档。 仅工作在 copy-in 模式。 -``` -$ find /etc | cpio -ovF /backups/etc.cpio -``` +!!! note "注意" -The result of the `find` command is sent as input to the `cpio` command via a _pipe_ (character `|`, AltGr + 6). + `cpio` 的一些选项需要与正确的操作模式相结合才能正常工作，参见 `man 1 cpio`。 -Here, the `find /etc` command returns a list of files corresponding to the contents of the `/etc` directory (recursively) to the `cpio` command, which performs the backup. +### copy-out 模式 -Do not forget the `>` sign when saving or the `F save_name_cpio`. +`cpio` 命令的语法： -| Options | Description | -| ------- | ---------------------------------------------- | -| `-o` | Creates a backup (_output_). | -| `-v` | Displays the name of the processed files. | -| `-F` | Designates the backup to be modified (medium). | +```bash +[files command |] cpio {-o| --create} [-options] [< file-list] [> device] +``` + +示例： -Backup to a media : +使用 `cpio` 输出的重定向： +```bash +find /etc | cpio -ov > /backups/etc.cpio ``` -$ find /etc | cpio -ov > /dev/rmt0 + +使用备份介质名称： + +```bash +find /etc | cpio -ovF /backups/etc.cpio ``` -The support can be of several types: +`find` 命令的结果作为输入通过 *管道*（字符 `|`, ++left-shift+backslash++）发送到 `cpio` 命令。 -* tape drive: `/dev/rmt0` ; -* a partition: `/dev/sda5`, `/dev/hda5`, etc. +在这里，`find /etc` 命令向执行备份的 `cpio` 命令返回与 `/etc` 目录内容（递归）对应的文件列表。 -### Type of backup +保存时不要忘记 `>` 符号或 `F save_name_cpio`。 -#### Backup with relative path +| 选项 | 说明 | +| ---- | ------------------------------------------- | +| `-o` | 使用 _cp-out_ 模式创建备份。 | +| `-v` | 显示已处理文件的名称。 | +| `-F` | 备份到指定介质，可以替换 `cpio` 命令中的标准输入（"<"）和标准输出（">"） | -``` -$ cd / -$ find etc | cpio -o > /backups/etc.cpio +备份到介质： + +```bash +find /etc | cpio -ov > /dev/rmt0 ``` -#### Backup with absolute path +介质可以有多种类型： +* 磁带驱动器：`/dev/rmt0`； +* 一个分区：`/dev/sda5`、`/dev/hda5` 等。 + +#### 文件列表的相对和绝对路径 + +```bash +cd / +find etc | cpio -o > /backups/etc.cpio ``` -$ find /etc | cpio -o > /backups/etc.A.cpio + +```bash +find /etc | cpio -o > /backups/etc.A.cpio ``` -!!! Warning If the path specified in the `find` command is **absolute** then the backup will be performed in **absolute**. +!!! warning "警告" - If the path indicated in the `find` command is **relative** then the backup will be done in **relative**. + 如果 `find` 命令中指定的路径是 **绝对**，则将在 **绝对** 路径中执行备份。 + + 如果 `find` 命令中指定的路径是 **相对**，则将在 **相对** 路径中执行备份。 -### Add to a backup +#### 向现有备份追加文件 -``` -[files command |] cpio {-o| --create} -A [-options] [device} +```bash +[files command |] cpio {-o| --create} -A [-options] [< fic-list] {F| > device} ``` -Example: +示例： -``` -$ find /etc/shadow | cpio -o -AF SystemFiles.A.cpio +```bash +find /etc/shadow | cpio -o -AF SystemFiles.A.cpio ``` -Adding files is only possible on direct access media. +只能在直接访问介质上添加文件。 -| Option | Description | -| ------ | ------------------------------------------- | -| `-A` | Adds one or more files to a backup on disk. | -| `-F` | Designates the backup to be modified. | +| 选项 | 说明 | +| ---- | --------------- | +| `-A` | 向现有备份追加一个或多个文件。 | +| `-F` | 指定要修改的备份。 | -### Compressing a backup +#### 压缩备份 -* Save **then** compress +* 保存 **然后** 压缩 -``` +```bash $ find /etc | cpio –o > etc.A.cpio $ gzip /backups/etc.A.cpio $ ls /backups/etc.A.cpio* /backups/etc.A.cpio.gz ``` -* Save **and** compress +* 保存 **并** 压缩 -``` -$ find /etc | cpio –o | gzip > /backups/etc.A.cpio.gz +```bash +find /etc | cpio –o | gzip > /backups/etc.A.cpio.gz ``` -There is no option, unlike the `tar` command, to save and compress at the same time. So it is done in two steps: saving and compressing. +与 `tar` 命令不同的是没有同时保存和压缩的选项。 因此，它分两步完成：保存和压缩。 -The syntax of the first method is easier to understand and remember, because it is done in two steps. +第一个方法的语法更容易理解和记忆，因为它分两步完成。 -For the first method, the backup file is automatically renamed by the `gzip` utility which adds `.gz` to the end of the file name. Similarly the `bzip2` utility automatically adds `.bz2`. +对于第一种方法，`gzip` 实用程序会自动重命名备份文件，并在文件名末尾添加 `.gz`。 同样，`bzip2` 实用程序会自动添加 `.bz2`。 -### Read the contents of a backup +### 读取备份的内容 -Syntax of the `cpio` command to read the contents of a _cpio_ backup: +读取 *cpio* 备份内容的 `cpio` 命令语法： -``` -cpio -t [-options] [ tmp cpio –iuE tmp -F etc.A.cpio rm -f tmp ``` -## Compression - decompression utilities +## 压缩 - 解压缩实用程序 -Using compression at the time of a backup can have a number of drawbacks: +在备份时使用压缩可能会有许多缺点： -* Lengthens the backup time as well as the restore time. -* It makes it impossible to add files to the backup. +* 延长了备份时间和恢复时间。 +* 这使得无法将文件添加到备份中。 -!!! Note It is therefore better to make a backup and compress it than to compress it during the backup. +!!! note "说明" -### Compressing with `gzip` + 因此，最好进行备份并压缩它，而不是在备份过程中压缩它。 -The `gzip` command compresses data. +### 使用 `gzip` 进行压缩 -Syntax of the `gzip` command: +`gzip` 命令压缩数据。 -``` +`gzip` 命令的语法： + +```bash gzip [options] [file ...] ``` -Example: +示例： -``` +```bash $ gzip usr.tar $ ls usr.tar.gz ``` -The file receives the extension `.gz`. +该文件的扩展名为 `.gz`。 -It keeps the same rights and the same last access and modification dates. +它保留相同的权限以及相同的最后访问和修改日期。 -### Compressing with `bunzip2` +### 使用 `bzip2` 进行压缩 -The `bunzip2` command also compresses data. +`bzip2` 命令也压缩数据。 -Syntax of the `bzip2` command: +`bzip2` 命令的语法： -``` +```bash bzip2 [options] [file ...] ``` -Example: +示例： -``` +```bash $ bzip2 usr.cpio $ ls usr.cpio.bz2 ``` -The file name is given the extension `.bz2`. +文件的扩展名为 `.bz2`。 -Compression by `bzip2` is better than compression by `gzip` but it takes longer to execute. +`bzip2` 压缩比 `gzip` 压缩要好，但执行它需要更长的时间。 -### Decompressing with `gunzip` +### 使用 `gunzip` 进行解压缩 -The `gunzip` command decompresses compressed data. +`gunzip` 命令用来解压压缩的数据。 -Syntax of the `gunzip` command: +`gunzip` 命令的语法： -``` +```bash gunzip [options] [file ...] ``` -Example: +示例： -``` +```bash $ gunzip usr.tar.gz $ ls usr.tar ``` -The file name is truncated by `gunzip` and the extension `.gz` is removed. +文件名被 `gunzip` 截断，扩展名 `.gz` 被删除。 -`gunzip` also decompresses files with the following extensions: +`gunzip` 还解压缩具有以下扩展名的文件： -* `.z` ; -* `-z` ; -* `_z` . +* `.z`； +* `-z`； +* `_z`； +* `-gz`； -### Decompressing with `bunzip2` +### 使用 `bunzip2` 进行解压缩 -The `bunzip2` command decompresses compressed data. +`bunzip2` 命令用来解压压缩的数据。 -Syntax of the `bzip2` command: +`bzip2` 命令的语法： -``` +```bash bzip2 [options] [file ...] ``` -Example: +示例： -``` +```bash $ bunzip2 usr.cpio.bz2 $ ls usr.cpio ``` -The file name is truncated by `bunzip2` and the extension `.bz2` is removed. +文件名被 `bunzip2` 截断，扩展名 `.bz2` 被删除。 -`bunzip2` also decompresses the file with the following extensions: +`bunzip2` 还解压缩具有以下扩展名的文件： -* `-bz` ; -* `.tbz2` ; -* `tbz` . +* `-bz`； +* `.tbz2`； +* `tbz`。 diff --git a/docs/desktop/display/installing_nvidia_gpu_drivers.de.md b/docs/desktop/display/installing_nvidia_gpu_drivers.de.md index 1516382363..219455d8d2 100644 --- a/docs/desktop/display/installing_nvidia_gpu_drivers.de.md +++ b/docs/desktop/display/installing_nvidia_gpu_drivers.de.md @@ -101,6 +101,8 @@ Der Wert von `GRUB_CMDLINE_LINUX` sollte in etwa dem folgenden Text ähneln, obw GRUB_CMDLINE_LINUX="resume=/dev/mapper/rl-swap rd.lvm.lv=rl/root rd.lvm.lv=rl/swap crashkernel=auto rhgb quiet nouveau.modeset=0 rd.driver.blacklist=nouveau" ``` +speichern Sie Ihre Änderungen mit: ++shift++colon+"w"+"q"++ + Laden Sie die Grub-Umgebung neu: ```bash diff --git a/docs/desktop/display/installing_nvidia_gpu_drivers.fr.md b/docs/desktop/display/installing_nvidia_gpu_drivers.fr.md index 4067979f0c..f66cb03a39 100644 --- a/docs/desktop/display/installing_nvidia_gpu_drivers.fr.md +++ b/docs/desktop/display/installing_nvidia_gpu_drivers.fr.md @@ -101,6 +101,8 @@ La valeur `GRUB_CMDLINE_LINUX` devrait ressembler au texte ci-dessous, bien qu'e GRUB_CMDLINE_LINUX="resume=/dev/mapper/rl-swap rd.lvm.lv=rl/root rd.lvm.lv=rl/swap crashkernel=auto rhgb quiet nouveau.modeset=0 rd.driver.blacklist=nouveau" ``` +Enregistrez vos modifications avec : ++shift++colon+"w"+"q"++ + Rechargez l'environnement `grub` : ```bash diff --git a/docs/desktop/display/installing_nvidia_gpu_drivers.uk.md b/docs/desktop/display/installing_nvidia_gpu_drivers.uk.md index e78cba7490..29e87ab40c 100644 --- a/docs/desktop/display/installing_nvidia_gpu_drivers.uk.md +++ b/docs/desktop/display/installing_nvidia_gpu_drivers.uk.md @@ -101,6 +101,8 @@ sudo vim /etc/default/grub GRUB_CMDLINE_LINUX="resume=/dev/mapper/rl-swap rd.lvm.lv=rl/root rd.lvm.lv=rl/swap crashkernel=auto rhgb quiet nouveau.modeset=0 rd.driver.blacklist=nouveau" ``` +Збережіть зміни за допомогою: ++shift+двокрапка+"w"+"q"+exclam++ + Перезавантажте середовище grub: ```bash diff --git a/docs/desktop/gnome/flatpak.de.md b/docs/desktop/gnome/flatpak.de.md index 84f5961a64..349f4a1e6a 100644 --- a/docs/desktop/gnome/flatpak.de.md +++ b/docs/desktop/gnome/flatpak.de.md @@ -130,7 +130,7 @@ Es ist nicht notwendig, sich die Liste der Befehle zu merken, es ist aber eine g !!! warning "Rocky Linux 8.x und `flatpak search`" ```` -If you are on a version of Rocky Linux 8.x, you will experience this bug. When running the command: +If you are on a Rocky Linux 8.x version, you will experience this bug. When running the command: ```bash flatpak search [packagename] diff --git a/docs/gemstones/git/01-gh_cli_1st_pr.de.md b/docs/gemstones/git/01-gh_cli_1st_pr.de.md new file mode 100644 index 0000000000..fb8edeafc5 --- /dev/null +++ b/docs/gemstones/git/01-gh_cli_1st_pr.de.md @@ -0,0 +1,89 @@ +--- +title: Erster Beitrag zur Rocky Linux-Dokumentation über CLI +author: Wale Soyinka +contributors: null +tags: + - GitHub + - Rocky Linux + - Mitwirkung + - Pull-Request + - CLI +--- + +## Einleitung + +In diesem Gemstone wird ausführlich beschrieben, wie Sie ausschließlich mithilfe der Befehlszeilenschnittstelle (CLI) zum Rocky Linux-Dokumentationsprojekt beitragen können. Es umfasst das erstmalige Forken des Repository und das Erstellen eines Pull-Requests. +In unserem Beispiel verwenden wir die Bereitstellung eines neuen Gemstone-Dokuments. + +## Problembeschreibung + +Mitwirkende möchten oder müssen möglicherweise alle Aktionen über die CLI ausführen, vom Forken von Repositorys bis zum erstmaligen Senden von Pull Requests. + +## Voraussetzungen + +- Ein Github-Konto +- `git` und `GitHub CLI (gh)` auf Ihrem System installiert +- Eine Markdown-Datei, die zur Veröffentlichung bereit ist + +## Lösung-Etappen + +1. **Repository mit GitHub CLI forken**: + Forken Sie das Upstream-Repository zu Ihrem Konto. + + ```bash + gh repo fork https://github.com/rocky-linux/documentation --clone + ``` + +2. **Navigieren zum Repository-Verzeichnis**: + + ```bash + cd documentation + ``` + +3. **Upstream-Repository hinzufügen**: + + ```bash + git remote add upstream https://github.com/rocky-linux/documentation.git + ``` + +4. **Neuen Zweig erstellen**: + Erstellen Sie einen neuen Zweig für Ihren Beitrag. Geben Sie bitte Folgendes ein: + + ```bash + git checkout -b new-gemstone + ``` + +5. **Neuen Zweig erstellen**: + Erstellen Sie einen neuen Zweig für Ihren Beitrag. + Für dieses Beispiel erstellen Sie eine neue Datei namens `gemstome_new_pr.md` im Verzeichnis „docs/gemstones/“. + +6. **Übernahme der Änderungen mit Commit**: + Stellen Sie Ihre neue Datei bereit mit `commit`. Geben Sie bitte Folgendes ein: + + ```bash + git add docs/gemstones/gemstome_new_pr.md + git commit -m "Add new Gemstone document" + ``` + +7. **Auf Ihren Fork mit Push übertragen**: + Übertragen Sie die Änderungen mit `push` auf Ihren Fork/Kopie des Rocky Linux-Dokumentationsrepos. Geben Sie bitte Folgendes ein: + + ```bash + git push origin new-gemstone + ``` + +8. **Pull Request erstellen**: + Erstellen Sie einen Pull Request an das Upstream-Repository. + + ```bash + gh pr create --base main --head wsoyinka:new-gemstone --title "New Gemstone: Creating PRs via CLI" --body "Guide on how to contribute to documentation using CLI" + ``` + +## Zusätzliche Informationen (optional) + +- Verwenden Sie `gh pr list` und `gh pr status`, um den Status Ihrer Pull Requests zu verfolgen. +- Lesen Sie die Beitragsrichtlinien des Rocky Linux-Dokumentationsprojekts und befolgen Sie diese. + +## Zusammenfassung + +Wenn Sie diese Schritte befolgen, sollten Sie in der Lage sein, Ihren PR erfolgreich zu erstellen und vollständig über die CLI zum Rocky Linux-Dokumentations-Repository beizutragen! diff --git a/docs/guides/cms/wordpress-on-lamp.uk.md b/docs/guides/cms/wordpress-on-lamp.uk.md index e8b581806e..2ccd975b0a 100644 --- a/docs/guides/cms/wordpress-on-lamp.uk.md +++ b/docs/guides/cms/wordpress-on-lamp.uk.md @@ -150,7 +150,7 @@ PHP — це програмування, яке використовується Створіть користувача з паролем для вашої бази даних: -!!! Note "Примітка" +!!! note "Примітка" ``` Настійно рекомендується використовувати надійний пароль. diff --git a/docs/rocky_insights/blogs/index.uk.md b/docs/rocky_insights/blogs/index.uk.md new file mode 100644 index 0000000000..9f40af2368 --- /dev/null +++ b/docs/rocky_insights/blogs/index.uk.md @@ -0,0 +1,37 @@ +--- +title: Вступ +author: Steven Spencer +contributors: null +--- + +## Чому цей розділ? + +Наприкінці 2024 року стало очевидно, що не кожен документ кешу документації Rocky Linux буде інструкцією. Нам потрібне було місце для довших, більш глибоких пояснень. Увійдіть у цей блог. + +## Хто тут може писати? + +Кожен, хто має облікові дані GitHub, може надіслати запропоновану статтю тут. Щоб розпочати, перегляньте документи в [розділі Внеси](https://docs.rockylinux.org/guides/contribute/). + +!!! note "Примітка" + +``` +Якщо у вас немає облікових даних GitHub, але ви все одно хочете написати щось для цього розділу, зв’яжіться з нами за посиланням на канал Mattermost унизу цієї сторінки. +``` + +Ви повинні переконатися, що ваш документ відповідає вимогам цього розділу. Наприклад: + +- Це підходить сюди? Наприклад, чи підходить це для цього формату блогу? Чи варто ділитися цією інформацією? +- Чи розкриває він тему, важливу для документалістів? +- Чи підвищить подання загальну якість документації Rocky Linux? + +## Яка інформація? + +Перші два документи тут повинні дати вам уявлення про те, що підходить. Протягом 2024 року ми докладали спільних зусиль, щоб усунути або суттєво скоротити пасивний стан у документах з інструкціями. У документі [Active voice: шлях до простого, ясного спілкування] (active_voice.md) описується важливість активного голосу в тональності документації, легкість читання та розуміння, а також спрощення перекладу іншими мовами. У документі [Open source: Чому це ніколи не ставиться через дефіс] (open_source.md) обговорюється велика дискусія навколо цього питання та аргументація нашого рішення не ставити через перенос. Зрозуміла ідея? Ці інформаційні документи не містять інструкцій, за винятком, можливо, прикладів. + +## Зростання цього блогу? + +Очікується, що цей набір документів зростатиме повільніше, ніж документи з інструкціями. Це нормально. Якість і відповідність документів тут найважливіше. + +## Зворотній зв'язок + +Як і щодо проекту документації в цілому, ви можете залишити відгук на нашому [Documentation Mattermost channel](https://chat.rockylinux.org/rocky-linux/channels/documentation).