git: f49917cd05 - main - update translation of books/fdp-primer to Russian

From: Vladlen Popolitov <vladlen_at_FreeBSD.org>
Date: Thu, 13 Aug 2026 14:02:53 UTC
The branch main has been updated by vladlen:

URL: https://cgit.FreeBSD.org/doc/commit/?id=f49917cd05955ba85f0adcad7da7308cae3f27d9

commit f49917cd05955ba85f0adcad7da7308cae3f27d9
Author:     Vladlen Popolitov <vladlen@FreeBSD.org>
AuthorDate: 2026-08-13 14:02:48 +0000
Commit:     Vladlen Popolitov <vladlen@FreeBSD.org>
CommitDate: 2026-08-13 14:02:48 +0000

    update translation of books/fdp-primer to Russian
    
    Differential Revision: https://reviews.freebsd.org/D58805
---
 .../fdp-primer/asciidoctor-primer/_index.adoc      |  11 +
 .../books/fdp-primer/asciidoctor-primer/_index.po  | 267 ++++++++-------
 .../ru/books/fdp-primer/overview/_index.adoc       |  22 +-
 .../content/ru/books/fdp-primer/overview/_index.po | 289 ++++++++--------
 .../books/fdp-primer/po-translations/_index.adoc   |   6 +-
 .../ru/books/fdp-primer/po-translations/_index.po  | 356 ++++++++++---------
 .../ru/books/fdp-primer/structure/_index.adoc      |   1 +
 .../ru/books/fdp-primer/structure/_index.po        | 361 ++++++++++---------
 .../ru/books/fdp-primer/translations/_index.adoc   |   2 -
 .../ru/books/fdp-primer/translations/_index.po     | 166 +++++----
 .../ru/books/fdp-primer/weblate/_index.adoc        |   2 +-
 .../content/ru/books/fdp-primer/weblate/_index.po  | 381 ++++++++++-----------
 .../ru/books/fdp-primer/writing-style/_index.adoc  |   2 +-
 .../ru/books/fdp-primer/writing-style/_index.po    | 330 +++++++++---------
 14 files changed, 1113 insertions(+), 1083 deletions(-)

diff --git a/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.adoc b/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.adoc
index f28f9bb943..9245d91e7e 100644
--- a/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.adoc
+++ b/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.adoc
@@ -249,6 +249,17 @@ crossref:doc-build[documentation-makefile, Эта ссылка]
 Не используйте макрос `xref` или его сокращение `<<` `>>`. Они не работают хорошо во всех выходных форматах.
 ====
 
+[IMPORTANT]
+====
+Когда второй параметр макроса `crossref` содержит запятую, он должен быть заключен в двойные кавычки. В противном случае запятая интерпретируется как разделитель параметров, и текст после запятой отбрасывается.
+
+Для примера:
+....
+crossref:plist[documentation-comma, "First, second"]
+....
+Без кавычек в качестве текста ссылки использовалось бы только слово `First`, а остальная часть была бы потеряна.
+====
+
 [[asciidoctor-images-icons]]
 == Изображения и иконки
 
diff --git a/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.po b/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.po
index ac0a8a7104..2fcdb75700 100644
--- a/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.po
+++ b/documentation/content/ru/books/fdp-primer/asciidoctor-primer/_index.po
@@ -5,8 +5,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: FreeBSD Documentation VERSION\n"
-"POT-Creation-Date: 2025-11-08 16:17+0000\n"
-"PO-Revision-Date: 2026-03-05 04:45+0000\n"
+"POT-Creation-Date: 2026-08-06 22:55+0100\n"
+"PO-Revision-Date: 2026-08-08 08:11+0000\n"
 "Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n"
 "Language-Team: Russian <https://translate-dev.freebsd.org/projects/"
 "documentation/booksfdp-primerasciidoctor-primer_index/ru/>\n"
@@ -37,7 +37,7 @@ msgid "Asciidoctor Primer"
 msgstr "Основы Asciidoctor"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:55
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:54
 msgid ""
 "Most FDP documentation is written with AsciiDoc.  This chapter explains what "
 "that means, how to read and understand the documentation source, and the "
@@ -57,13 +57,13 @@ msgstr ""
 "AsciiDoc]."
 
 #. type: Title ==
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:57
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:56
 #, no-wrap
 msgid "Overview"
 msgstr "Обзор"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:63
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:62
 msgid ""
 "In the original days of computers, electronic text was simple.  There were a "
 "few character sets like ASCII or EBCDIC, but that was about it.  Text was "
@@ -76,7 +76,7 @@ msgstr ""
 "получали.  Никаких изысков, никакого форматирования, никакого интеллекта."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:68
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:67
 msgid ""
 "Inevitably, this was not enough.  When text is in a machine-usable format, "
 "machines are expected to be able to use and manipulate it intelligently.  "
@@ -94,7 +94,7 @@ msgstr ""
 "из множества вариантов представления."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:72
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:71
 msgid ""
 "It was once hoped that Artificial Intelligence (AI) would make this easy.  "
 "The computer would read the document and automatically identify key phrases, "
@@ -110,7 +110,7 @@ msgstr ""
 "текст."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:75
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:74
 msgid ""
 "More precisely, they need help identifying what is what.  Consider this text:"
 msgstr ""
@@ -118,18 +118,18 @@ msgstr ""
 "текст:"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:77
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:76
 msgid "To remove [.filename]#/tmp/foo#, use man:rm[1]."
 msgstr "Для удаления [.filename]#/tmp/foo# используйте man:rm[1]."
 
 #. type: delimited block - 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:81
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:80
 #, no-wrap
 msgid "% rm /tmp/foo\n"
 msgstr "% rm /tmp/foo\n"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:86
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:85
 msgid ""
 "It is easy for the reader to see which parts are filenames, which are "
 "commands to be typed in, which parts are references to manual pages, and so "
@@ -142,20 +142,20 @@ msgstr ""
 "Для этого нам нужна разметка."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:88
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:87
 msgid ""
 "The previous example is actually represented in this document like this:"
 msgstr ""
 "Предыдущий пример фактически представлен в этом документе следующим образом:"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:91
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:90
 #, no-wrap
 msgid "To remove */tmp/foo*, use man:rm[1].\n"
 msgstr "To remove */tmp/foo*, use man:rm[1].\n"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:96
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:95
 #, no-wrap
 msgid ""
 "[source,shell]\n"
@@ -169,13 +169,13 @@ msgstr ""
 "----\n"
 
 #. type: Title ==
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:99
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:98
 #, no-wrap
 msgid "Headings"
 msgstr "Заголовки"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:104
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:103
 msgid ""
 "Asciidoctor supports six headings levels.  If the document type is `article` "
 "only one level 0 (`=`) can be used.  If the document type is `book` then "
@@ -186,87 +186,87 @@ msgstr ""
 "тип документа `book`, то может быть несколько заголовков уровня 0 (`=`)."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:106
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:105
 msgid "This is an example of headings in an `article`."
 msgstr "Вот пример заголовков в документе типа `article`."
 
 #. type: Title =
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:108
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:107
 #, no-wrap
 msgid "Document Title (Level 0)"
 msgstr "Заголовок документа (Уровень 0)"
 
 #. type: Title ==
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:110
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:109
 #, no-wrap
 msgid "Level 1 Section Title"
 msgstr "Заголовок раздела на уровне 1"
 
 #. type: Title ===
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:112
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:111
 #, no-wrap
 msgid "Level 2 Section Title"
 msgstr "Заголовок раздела на уровне 2"
 
 #. type: Title ====
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:114
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:113
 #, no-wrap
 msgid "Level 3 Section Title"
 msgstr "Заголовок раздела на уровне 3"
 
 #. type: Title =====
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:116
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:115
 #, no-wrap
 msgid "Level 4 Section Title"
 msgstr "Заголовок раздела на уровне 4"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:119
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:118
 msgid "====== Level 5 Section Title"
 msgstr "====== Заголовок раздела на уровне 5"
 
 #. type: Title ==
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:120
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:119
 #, no-wrap
 msgid "Another Level 1 Section Title"
 msgstr "Другой заголовок раздела на уровне 1"
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:126
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:125
 msgid "Section levels cannot be skipped when nesting sections."
 msgstr "Уровни разделов нельзя пропускать при вложении разделов."
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:128
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:127
 msgid "The following syntax is not correct."
 msgstr "Следующий синтаксис неверен."
 
 #. type: Title =
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:130
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:129
 #, no-wrap
 msgid "Document Title"
 msgstr "Заголовок документа"
 
 #. type: Title ==
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:132
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:131
 #, no-wrap
 msgid "Level 1"
 msgstr "Уровень 1"
 
 #. type: Title ====
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:134
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:133
 #, no-wrap
 msgid "Level 3"
 msgstr "Уровень 3"
 
 #. type: Title ==
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:139
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:138
 #, no-wrap
 msgid "Paragraphs"
 msgstr "Абзацы"
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:144
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:143
 msgid ""
 "Paragraphs don't require special markup in AsciiDoc.  A paragraph is defined "
 "by one or more consecutive lines of text.  To create a new paragraph leave "
@@ -277,34 +277,34 @@ msgstr ""
 "абзац, оставьте одну пустую строку."
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:146
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:145
 msgid "For example, this is a heading with two paragraphs."
 msgstr "Например, это заголовок с двумя абзацами."
 
 #. type: Title =
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:148
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:147
 #, no-wrap
 msgid "This is the heading"
 msgstr "Это заголовок"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:152
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:151
 msgid "This is the first paragraph.  This is also the first paragraph."
 msgstr "Это первый абзац.  Это тоже первый абзац."
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:154
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:153
 msgid "And this is the second paragraph."
 msgstr "А это второй абзац."
 
 #. type: Title ==
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:157
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:156
 #, no-wrap
 msgid "Lists"
 msgstr "Списки"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:161
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:160
 msgid ""
 "Asciidoctor supports a few types of lists, the most common are `ordered` and "
 "`unordered`.  To get more information about lists, see link:https://docs."
@@ -317,23 +317,23 @@ msgstr ""
 "reference/#lists[AsciiDoc Syntax Quick Reference]."
 
 #. type: Title ===
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:163
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:162
 #, no-wrap
 msgid "Ordered lists"
 msgstr "Упорядоченные списки"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:166
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:165
 msgid "To create an ordered list use the `.` character."
 msgstr "Для создания нумерованного списка используйте символ `.`."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:168
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:167
 msgid "For example, this is an ordered list."
 msgstr "Например, это нумерованный список."
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:174
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:173
 #, no-wrap
 msgid ""
 ". First item\n"
@@ -347,54 +347,54 @@ msgstr ""
 ". Третий пункт\n"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:177
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:198
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:241
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:176
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:197
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:240
 msgid "And this would be rendered as."
 msgstr "И это будет отображено как."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:179
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:200
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:178
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:199
 msgid "First item"
 msgstr "Первый пункт"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:180
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:201
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:179
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:200
 msgid "Second item"
 msgstr "Второй пункт"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:181
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:202
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:180
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:201
 msgid "Subsecond item"
 msgstr "Подпункт второго пункта"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:182
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:203
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:181
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:202
 msgid "Third item"
 msgstr "Третий пункт"
 
 #. type: Title ===
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:184
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:183
 #, no-wrap
 msgid "Unordered lists"
 msgstr "Неупорядоченные списки"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:187
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:186
 msgid "To create an unordered list use the `*` character."
 msgstr "Для создания маркированного списка используйте символ `*`."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:189
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:188
 msgid "For example, this is an unordered list."
 msgstr "Например, это ненумерованный список."
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:195
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:194
 #, no-wrap
 msgid ""
 "* First item\n"
@@ -408,30 +408,30 @@ msgstr ""
 "* Третий пункт\n"
 
 #. type: Title ==
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:205
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:204
 #, no-wrap
 msgid "Links"
 msgstr "Ссылки"
 
 #. type: Title ===
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:208
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:207
 #, no-wrap
 msgid "External links"
 msgstr "Внешние ссылки"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:211
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:210
 msgid "To point to another website the `link` macro should be used."
 msgstr "Чтобы указать на другой веб-сайт, следует использовать макрос `link`."
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:214
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:213
 #, no-wrap
 msgid "link:https://www.FreeBSD.org[FreeBSD]\n"
 msgstr "link:https://www.FreeBSD.org[FreeBSD]\n"
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:220
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:219
 msgid ""
 "As the Asciidoctor documentation describes, the `link` macro is not required "
 "when the target starts with a URL scheme like `https`.  However, it is a "
@@ -445,13 +445,13 @@ msgstr ""
 "как японский."
 
 #. type: Title ===
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:223
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:222
 #, no-wrap
 msgid "Links to another book or article"
 msgstr "Ссылки на другую книгу или статью"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:227
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:226
 msgid ""
 "To point to another book or article the Asciidoctor variables should be "
 "used.  For example, if we are in the `cups` article and we want to point to "
@@ -462,7 +462,7 @@ msgstr ""
 "на `ipsec-must`, необходимо выполнить следующие шаги."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:229
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:228
 msgid ""
 "Include the [.filename]#urls.adoc# file from [.filename]#~/doc/shared# "
 "folder."
@@ -470,13 +470,13 @@ msgstr ""
 "Включите файл [.filename]#urls.adoc# из папки [.filename]#~/doc/shared#."
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:232
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:231
 #, no-wrap
 msgid "\\include::shared/{lang}/urls.adoc[]\n"
 msgstr "\\include::shared/{lang}/urls.adoc[]\n"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:235
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:234
 msgid ""
 "Then create a link using the Asciidoctor variable to the `ipsec-must` "
 "article."
@@ -485,18 +485,18 @@ msgstr ""
 "`ipsec-must`."
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:238
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:237
 #, no-wrap
 msgid "extref:{ipsec-must}[IPSec-Must article]\n"
 msgstr "extref:{ipsec-must}[Статья IPSec-Must]\n"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:243
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:242
 msgid "extref:{ipsec-must}[IPSec-Must article]"
 msgstr "extref:{ipsec-must}[Статья IPSec-Must]"
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:248
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:247
 msgid ""
 "The `extref` macro is defined as an extension.  It is designed to render the "
 "correct link across the different outputs"
@@ -505,13 +505,13 @@ msgstr ""
 "отображения ссылки в различных выходных форматах"
 
 #. type: Title ===
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:250
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:249
 #, no-wrap
 msgid "Links to the same file or to another file in the same book"
 msgstr "Ссылки на тот же файл или на другой файл в той же книге"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:255
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:254
 msgid ""
 "Books are structured in different directories to keep a sane layout.  To "
 "create a link from one subdirectory of a book to another subdirectory of the "
@@ -522,23 +522,23 @@ msgstr ""
 "подкаталог той же книги, используйте макрос `crossref`:"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:257
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:256
 #, no-wrap
 msgid "crossref:doc-build[documentation-makefile, This link]\n"
 msgstr "crossref:doc-build[documentation-makefile, Эта ссылка]\n"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:259
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:258
 msgid "And this would be rendered as"
 msgstr "И это будет отображено как"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:261
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:260
 msgid "crossref:doc-build[documentation-makefile, This link]"
 msgstr "crossref:doc-build[documentation-makefile, Эта ссылка]"
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:266
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:265
 msgid ""
 "The `crossref` macro is defined as an extension.  It is designed to render "
 "the correct link across the different outputs"
@@ -547,7 +547,7 @@ msgstr ""
 "формирования корректной ссылки в различных выходных форматах"
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:273
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:272
 msgid ""
 "Use the `crossref` macro for intra-document links too.  Although it might be "
 "inconvenient to write the name of the current document, it ensures the "
@@ -558,7 +558,7 @@ msgstr ""
 "отображение ссылки в различных выходных форматах"
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:279
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:278
 msgid ""
 "Do not use either the `xref` macro or its shortcut `<<` `>>`.  They do not "
 "work well in all output formats."
@@ -566,14 +566,45 @@ msgstr ""
 "Не используйте макрос `xref` или его сокращение `<<` `>>`.  Они не работают "
 "хорошо во всех выходных форматах."
 
+#. type: delimited block = 4
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:284
+msgid ""
+"When the second parameter of the `crossref` macro contains a comma, it must "
+"be enclosed in double quotes.  Otherwise, the comma is interpreted as a "
+"parameter separator, and the text after the comma is stripped."
+msgstr ""
+"Когда второй параметр макроса `crossref` содержит запятую, он должен быть "
+"заключен в двойные кавычки. В противном случае запятая интерпретируется как "
+"разделитель параметров, и текст после запятой отбрасывается."
+
+#. type: delimited block = 4
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:286
+msgid "For example:"
+msgstr "Для примера:"
+
+#. type: delimited block . 4
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:288
+#, no-wrap
+msgid "crossref:plist[documentation-comma, \"First, second\"]\n"
+msgstr "crossref:plist[documentation-comma, \"First, second\"]\n"
+
+#. type: Plain text
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:290
+msgid ""
+"Without quotes, only `First` would be used as the link text, and the rest "
+"would be lost."
+msgstr ""
+"Без кавычек в качестве текста ссылки использовалось бы только слово `First`, "
+"а остальная часть была бы потеряна."
+
 #. type: Title ==
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:282
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:293
 #, no-wrap
 msgid "Images and Icons"
 msgstr "Изображения и иконки"
 
-#. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:286
+#. type: delimited block = 4
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:297
 msgid ""
 "Images and icons play a crucial role in enhancing the overall user "
 "experience.  These visual elements are strategically integrated to convey "
@@ -585,13 +616,13 @@ msgstr ""
 "визуально привлекательного интерфейса."
 
 #. type: Title ===
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:288
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:299
 #, no-wrap
 msgid "Images"
 msgstr "Изображения"
 
-#. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:291
+#. type: delimited block = 4
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:302
 msgid ""
 "Images help illustrate complex concepts, making them more accessible to "
 "users."
@@ -599,24 +630,24 @@ msgstr ""
 "Изображения помогают проиллюстрировать сложные концепции, делая их более "
 "понятными для пользователей."
 
-#. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:293
+#. type: delimited block = 4
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:304
 msgid ""
 "The first step will be to add the image in the images directory in the path:"
 msgstr "Первым шагом будет добавление изображения в каталог `images` по пути:"
 
-#. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:295
+#. type: delimited block = 4
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:306
 msgid "[.filename]#~/website/static/images/# for the website."
 msgstr "[.filename]#~/website/static/images/# для веб-сайта."
 
-#. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:296
+#. type: delimited block = 4
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:307
 msgid "[.filename]#~/documentation/static/images/# for the documentation."
 msgstr "[.filename]#~/documentation/static/images/# для документации."
 
-#. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:298
+#. type: delimited block = 4
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:309
 msgid ""
 "For example, to add a new image to the FreeBSD installation process, the "
 "image will be saved to the path [.filename]#~/documentation/static/images/"
@@ -626,8 +657,8 @@ msgstr ""
 "изображение сохраняется по пути [.filename]#~/documentation/static/images/"
 "books/handbook/bsdinstall/new-image3.png#."
 
-#. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:300
+#. type: delimited block = 4
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:311
 msgid ""
 "The next step will be to configure the Asciidoctor attributes `images-path` "
 "and `imagesdir`."
@@ -635,8 +666,8 @@ msgstr ""
 "Следующим шагом будет настройка атрибутов Asciidoctor `images-path` и "
 "`imagesdir`."
 
-#. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:302
+#. type: delimited block = 4
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:313
 msgid ""
 "We are going to use as an example the header of the extref:{freebsd-releng}"
 "[FreeBSD Release Engineering] article."
@@ -645,45 +676,45 @@ msgstr ""
 "[Подготовка релизов FreeBSD]."
 
 #. type: Title =
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:305
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:316
 #, no-wrap
 msgid "FreeBSD Release Engineering"
 msgstr "Подготовка релизов FreeBSD"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:307
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:318
 msgid ":doctype: article"
 msgstr ":doctype: article"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:309
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:313
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:317
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:320
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:324
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:328
 msgid "[...]"
 msgstr "[...]"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:311
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:322
 msgid ":images-path: articles/freebsd-releng/ <1>"
 msgstr ":images-path: articles/freebsd-releng/ <1>"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:315
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:326
 msgid ":imagesdir: ../../../images/{images-path} <2>"
 msgstr ":imagesdir: ../../../images/{images-path} <2>"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:321
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:332
 msgid "Makes reference to the path inside [.filename]#/static/images# folder."
 msgstr "Ссылается на путь внутри папки [.filename]#/static/images#."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:322
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:333
 msgid "Makes reference to the Asciidoctor attribute."
 msgstr "Делает ссылку на атрибут Asciidoctor."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:324
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:335
 msgid ""
 "Once the image is in the correct path and the Asciidoctor attributes have "
 "been configured in the document, the `image` macro can be used."
@@ -692,18 +723,18 @@ msgstr ""
 "настроены в документе, можно использовать макрос `image`."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:326
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:337
 msgid "This is an example:"
 msgstr "Вот пример:"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:329
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:340
 #, no-wrap
 msgid "image::new-image3.png[New step in the FreeBSD install process]\n"
 msgstr "image::new-image3.png[New step in the FreeBSD install process]\n"
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:334
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:345
 msgid ""
 "To improve accessibility, it is mandatory to add descriptive text to each "
 "image."
@@ -712,20 +743,20 @@ msgstr ""
 "изображению."
 
 #. type: Title ===
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:337
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:348
 #, no-wrap
 msgid "Icons"
 msgstr "Иконки"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:340
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:351
 msgid "Icons serve as intuitive symbols for quick recognition and navigation."
 msgstr ""
 "Иконки служат интуитивно понятными символами для быстрого распознавания и "
 "навигации."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:342
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:353
 msgid ""
 "The first step to use icons is to add the `icons` property to the "
 "Asciidoctor properties section, at the top of each document."
@@ -734,13 +765,13 @@ msgstr ""
 "раздел свойств Asciidoctor в начале каждого документа."
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:345
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:356
 #, no-wrap
 msgid ":icons: font\n"
 msgstr ":icons: font\n"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:348
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:359
 msgid ""
 "Once the Asciidoctor icon property has been set an icon supported by link:"
 "https://fontawesome.com/v4/icons/[Font Awesome] can be added."
@@ -749,18 +780,18 @@ msgstr ""
 "поддерживаемую link:https://fontawesome.com/v4/icons/[Font Awesome]."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:350
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:361
 msgid "This is an example about how to use the `envelope` icon:"
 msgstr "Это пример использования иконки `envelope`:"
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:353
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:364
 #, no-wrap
 msgid "icon:envelope[link=mailto:test@example.com, title=\"contact\"]\n"
 msgstr "icon:envelope[link=mailto:test@example.com, title=\"contact\"]\n"
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:358
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:369
 msgid ""
 "To improve the accessibility of the website, the `title` attribute is "
 "mandatory."
@@ -768,13 +799,13 @@ msgstr ""
 "Для повышения доступности веб-сайта атрибут `title` является обязательным."
 
 #. type: Title ==
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:361
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:372
 #, no-wrap
 msgid "Conclusion"
 msgstr "Заключение"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:364
+#: documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc:375
 msgid ""
 "This is the conclusion of this Asciidoctor primer.  For reasons of space and "
 "complexity, several things have not been covered in depth (or at all)."
diff --git a/documentation/content/ru/books/fdp-primer/overview/_index.adoc b/documentation/content/ru/books/fdp-primer/overview/_index.adoc
index 90d0ab3bd2..d698ad66bb 100644
--- a/documentation/content/ru/books/fdp-primer/overview/_index.adoc
+++ b/documentation/content/ru/books/fdp-primer/overview/_index.adoc
@@ -153,10 +153,12 @@ endif::[]
 [source, shell]
 ....
 % git commit
-% git format-patch origin/main
+% git format-patch -U999999 origin/main
 ....
 +
-Патч, созданный с помощью `git format-patch`, будет содержать идентификатор автора и адреса электронной почты, что упрощает применение разработчиками (с помощью `git am`) и правильное указание авторства.
+Параметр `-U999999` добавляет в файл патча максимальное количество контекста, что делает процесс рецензирования проще.
++
+Файл патча, созданный с помощью `git format-patch` в локальном каталоге, будет содержать идентификатор автора и адреса электронной почты, что упрощает применение разработчиками (с помощью `git am`) и правильное указание авторства.
 +
 [IMPORTANT]
 ======
@@ -165,7 +167,7 @@ endif::[]
 +
 В приведённом выше примере были внесены изменения в раздел *bsdinstall* Руководства.
 +
-. Отправьте патч или diff-файл с помощью веб-системы https://bugs.FreeBSD.org/bugzilla/enter_bug.cgi?product=Documentation[Problem Report]. При использовании веб-формы укажите в поле Summary _[patch] краткое описание проблемы_. Выберите Component `Documentation`. В поле Description введите краткое описание изменений и любые важные детали о них. Используйте кнопку btn:[Add an attachment], чтобы прикрепить патч или diff-файл. Наконец, нажмите кнопку btn:[Submit Bug], чтобы отправить ваш diff в систему отчётов об ошибках.
+. Отправьте патч или diff-файл с помощью веб-системы https://bugs.FreeBSD.org/bugzilla/enter_bug.cgi?product=Documentation[Problem Report]. В поле `Component` выберите ту часть документации, к которой относится изменение. В поле `Summary` введите _краткое описание проблемы_. В поле `Description` введите краткое описание изменений и любые важные детали о них. Используйте кнопку btn:[Add an attachment], чтобы прикрепить патч или diff-файл. Наконец, нажмите кнопку btn:[Submit Bug], чтобы отправить ваш diff в систему отчётов об ошибках.
 ====
 
 [[gnu-linux-installation-process]]
@@ -177,7 +179,7 @@ endif::[]
 +
 [source, shell]
 ....
-# apt install hugo ruby-asciidoctor ruby-asciidoctor-pdf ruby-rouge git bmake
+# apt install asciidoctor hugo ruby-asciidoctor-pdf ruby-rouge git bmake
 ....
 +
 . Установите локальную рабочую копию документации из репозитория FreeBSD в [.filename]#~/doc# (см. crossref:working-copy[working-copy,Рабочая копия]).
@@ -211,10 +213,12 @@ endif::[]
 [source, shell]
 ....
 % git commit
-% git format-patch origin/main
+% git format-patch -U999999 origin/main
 ....
 +
-Патч, созданный с помощью `git format-patch`, будет содержать идентификатор автора и адреса электронной почты, что упрощает применение разработчиками (с помощью `git am`) и правильное указание авторства.
+Параметр `-U999999` добавляет в файл патча максимальное количество контекста, что делает процесс рецензирования проще.
++
+Файл патча, созданный с помощью `git format-patch` в локальном каталоге, будет содержать идентификатор автора и адреса электронной почты, что упрощает применение разработчиками (с помощью `git am`) и правильное указание авторства.
 +
 [IMPORTANT]
 ======
@@ -284,10 +288,12 @@ $ bmake run USE_RUBYGEMS=YES RUBY_CMD="$(brew --prefix ruby)/bin/ruby" HUGO_CMD=
 [source, shell]
 ....
 % git commit
-% git format-patch origin/main
+% git format-patch -U999999 origin/main
 ....
 +
-Патч, созданный с помощью `git format-patch`, будет содержать идентификатор автора и адреса электронной почты, что упрощает применение разработчиками (с помощью `git am`) и правильное указание авторства.
+Параметр `-U999999` добавляет в файл патча максимальное количество контекста, что делает процесс рецензирования проще.
++
+Файл патча, созданный с помощью `git format-patch` в локальном каталоге, будет содержать идентификатор автора и адреса электронной почты, что упрощает применение разработчиками (с помощью `git am`) и правильное указание авторства.
 +
 [IMPORTANT]
 ======
diff --git a/documentation/content/ru/books/fdp-primer/overview/_index.po b/documentation/content/ru/books/fdp-primer/overview/_index.po
index 8e4e597ad5..c5d0b94fb3 100644
--- a/documentation/content/ru/books/fdp-primer/overview/_index.po
+++ b/documentation/content/ru/books/fdp-primer/overview/_index.po
@@ -5,8 +5,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: FreeBSD Documentation VERSION\n"
-"POT-Creation-Date: 2026-03-15 14:20+0300\n"
-"PO-Revision-Date: 2026-03-05 04:45+0000\n"
+"POT-Creation-Date: 2026-08-06 22:55+0100\n"
+"PO-Revision-Date: 2026-08-08 04:45+0000\n"
 "Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n"
 "Language-Team: Russian <https://translate-dev.freebsd.org/projects/"
 "documentation/booksfdp-primeroverview_index/ru/>\n"
@@ -37,7 +37,7 @@ msgid "Overview"
 msgstr "Обзор"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:53
+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:52
 msgid ""
 "Welcome to the FreeBSD Documentation Project (FDP).  Quality documentation "
 "is crucial to the success of FreeBSD, and we value your contributions very "
@@ -48,7 +48,7 @@ msgstr ""
 "вклад."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:55
+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:54
 msgid ""
 "This document describes how the FDP is organized, how to write and submit "
 "documentation, and how to effectively use the available tools."
@@ -57,7 +57,7 @@ msgstr ""
 "документацию, а также как эффективно использовать доступные инструменты."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:58
+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:57
 msgid ""
 "Everyone is welcome to contribute to the FDP.  Willingness to contribute is "
 "the only membership requirement."
@@ -66,44 +66,44 @@ msgstr ""
 "требование для участия."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:60
+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:59
 msgid "This primer shows how to:"
 msgstr "Это руководство показывает, как:"
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:62
+#: documentation/content/en/books/fdp-primer/overview/_index.adoc:61
 msgid "Understand the role of documentation and its place in the ecosystem."
 msgstr "Понять роль документации и её место в экосистеме."
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/overview/_index.adoc:63
*** 6143 LINES SKIPPED ***