Proofread docs in the /operation directory (#1710)

* Proofread boot-options.rst

* Fix line length Markdown lint errors

* Proofread information.rst

* Update lastproofread date in information.rst

* Updated password-recovery.rst

* Proofread upgrade-recovery.rst

* Fix line length linting errors

* Proofread up to Empty 2+ Disk

* Complete proofread of raid.rst

* Update upgrade-recovery timeout explanation

* Fix header formatting

* Update docs/operation/boot-options.rst

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Add missing period in raid.rst

* Implement Copilot feedback


---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Daniil Baturin <daniil@baturin.org>

docs/_locale/de/operation.pot

@@ -13,24 +13,24 @@ msgid "1 - Remove the failed disk from the RAID 1 set by issuing the following c
 msgstr "1 - Remove the failed disk from the RAID 1 set by issuing the following command:"
 
 #: ../../operation/raid.rst:113
-msgid "1 - To break apart the current RAID 1 set, enter “No” at the prompt. The"
+msgid "1 - To break apart the current RAID 1 set, enter **No** at the prompt. The"
-msgstr "1 - To break apart the current RAID 1 set, enter “No” at the prompt. The"
+msgstr "1 - To break apart the current RAID 1 set, enter **No** at the prompt. The"
 
 #: ../../operation/raid.rst:71
-msgid "1 - To create a new RAID 1 array, enter “Yes” at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
+msgid "1 - To create a new RAID 1 array, enter **Yes** at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
-msgstr "1 - To create a new RAID 1 array, enter “Yes” at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
+msgstr "1 - To create a new RAID 1 array, enter **Yes** at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
 
 #: ../../operation/raid.rst:162
 msgid "2- Physically remove the failed disk from the system. If the drives are not hot-swappable, then you must shut down the system before removing the disk."
 msgstr "2- Physically remove the failed disk from the system. If the drives are not hot-swappable, then you must shut down the system before removing the disk."
 
 #: ../../operation/raid.rst:123
-msgid "2 - To decline to set up a new RAID 1 configuration on the disks, enter “No” at the prompt. The system prompts you to indicate which partition you would like the system installed on."
+msgid "2 - To decline to set up a new RAID 1 configuration on the disks, enter **No** at the prompt. The system prompts you to indicate which partition you would like the system installed on."
-msgstr "2 - To decline to set up a new RAID 1 configuration on the disks, enter “No” at the prompt. The system prompts you to indicate which partition you would like the system installed on."
+msgstr "2 - To decline to set up a new RAID 1 configuration on the disks, enter **No** at the prompt. The system prompts you to indicate which partition you would like the system installed on."
 
 #: ../../operation/raid.rst:79
-msgid "2 - To overwrite the old filesystem, enter “Yes”."
+msgid "2 - To overwrite the old filesystem, enter **Yes**."
-msgstr "2 - To overwrite the old filesystem, enter “Yes”."
+msgstr "2 - To overwrite the old filesystem, enter **Yes**."
 
 #: ../../operation/raid.rst:131
 msgid "3 - Enter the partition where you would like the system installed. The system then prompts you to indicate whether you want to save the old configuration data. This represents the current VyOS configuration."
@@ -46,8 +46,8 @@ msgstr "3 - The system informs you that all data on both drives will be erased.
 
 #: ../../operation/raid.rst:88
 #: ../../operation/raid.rst:139
-msgid "4 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgid "4 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
-msgstr "4 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgstr "4 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
 
 #: ../../operation/raid.rst:167
 msgid "4 - Format the new disk for RAID 1 by issuing the following command:"
@@ -62,8 +62,8 @@ msgid "5 - Continue with installation in the normal way."
 msgstr "5 - Continue with installation in the normal way."
 
 #: ../../operation/raid.rst:96
-msgid "5 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgid "5 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
-msgstr "5 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgstr "5 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
 
 #: ../../operation/raid.rst:99
 msgid "6 - Continue with installation in the normal way."
@@ -126,8 +126,8 @@ msgid "If a device is unplugged and re-plugged it will receive a new Port, Dev,
 msgstr "If a device is unplugged and re-plugged it will receive a new Port, Dev, If identification."
 
 #: ../../operation/raid.rst:57
-msgid "If you do not want to configure RAID 1 mirroring, enter “No” at the prompt and continue with installation in the normal way."
+msgid "If you do not want to configure RAID 1 mirroring, enter **No** at the prompt and continue with installation in the normal way."
-msgstr "If you do not want to configure RAID 1 mirroring, enter “No” at the prompt and continue with installation in the normal way."
+msgstr "If you do not want to configure RAID 1 mirroring, enter **No** at the prompt and continue with installation in the normal way."
 
 #: ../../operation/information.rst:21
 msgid "In the past serial interface have been defined as ttySx and ttyUSBx where x was an instance number of the serial interface. It was discovered that from system boot to system boot the mapping of USB based serial interfaces will differ, depending which driver was loaded first by the operating system. This will become rather painful if you not only have serial interfaces for a console server connected but in addition also a serial backed :ref:`wwan-interface`."

docs/_locale/es/operation.pot

@@ -13,11 +13,11 @@ msgid "1 - Remove the failed disk from the RAID 1 set by issuing the following c
 msgstr "1: elimine el disco fallido del conjunto RAID 1 emitiendo el siguiente comando:"
 
 #: ../../operation/raid.rst:113
-msgid "1 - To break apart the current RAID 1 set, enter “No” at the prompt. The"
+msgid "1 - To break apart the current RAID 1 set, enter **No** at the prompt. The"
 msgstr "1 - Para dividir el conjunto RAID 1 actual, ingrese "No" en el indicador. El"
 
 #: ../../operation/raid.rst:71
-msgid "1 - To create a new RAID 1 array, enter “Yes” at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
+msgid "1 - To create a new RAID 1 array, enter **Yes** at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
 msgstr "1 - Para crear una nueva matriz RAID 1, ingrese "Sí" en el indicador. Si el sistema detecta un sistema de archivos en las particiones que se utilizan para RAID 1, le pedirá que indique si desea continuar creando la matriz RAID 1."
 
 #: ../../operation/raid.rst:162
@@ -25,11 +25,11 @@ msgid "2- Physically remove the failed disk from the system. If the drives are n
 msgstr "2- Retire físicamente el disco fallido del sistema. Si las unidades no son intercambiables en caliente, debe apagar el sistema antes de extraer el disco."
 
 #: ../../operation/raid.rst:123
-msgid "2 - To decline to set up a new RAID 1 configuration on the disks, enter “No” at the prompt. The system prompts you to indicate which partition you would like the system installed on."
+msgid "2 - To decline to set up a new RAID 1 configuration on the disks, enter **No** at the prompt. The system prompts you to indicate which partition you would like the system installed on."
 msgstr "2 - Para negarse a establecer una nueva configuración RAID 1 en los discos, ingrese "No" en el indicador. El sistema le solicita que indique en qué partición desea instalar el sistema."
 
 #: ../../operation/raid.rst:79
-msgid "2 - To overwrite the old filesystem, enter “Yes”."
+msgid "2 - To overwrite the old filesystem, enter **Yes**."
 msgstr "2 - Para sobrescribir el antiguo sistema de archivos, ingrese "Sí"."
 
 #: ../../operation/raid.rst:131
@@ -46,7 +46,7 @@ msgstr "3 - El sistema le informa que se borrarán todos los datos de ambas unid
 
 #: ../../operation/raid.rst:88
 #: ../../operation/raid.rst:139
-msgid "4 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgid "4 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
 msgstr "4 - Ingrese "Sí" en el mensaje para conservar la configuración actual de VyOS una vez que se complete la instalación. Ingrese "No" para eliminar la configuración actual de VyOS."
 
 #: ../../operation/raid.rst:167
@@ -62,7 +62,7 @@ msgid "5 - Continue with installation in the normal way."
 msgstr "5 - Continuar con la instalación de forma normal."
 
 #: ../../operation/raid.rst:96
-msgid "5 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgid "5 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
 msgstr "5 - Ingrese "Sí" en el mensaje para conservar la configuración actual de VyOS una vez que se complete la instalación. Ingrese "No" para eliminar la configuración actual de VyOS."
 
 #: ../../operation/raid.rst:99
@@ -126,7 +126,7 @@ msgid "If a device is unplugged and re-plugged it will receive a new Port, Dev,
 msgstr "Si un dispositivo se desenchufa y se vuelve a enchufar, recibirá una nueva identificación de Puerto, Dev, If."
 
 #: ../../operation/raid.rst:57
-msgid "If you do not want to configure RAID 1 mirroring, enter “No” at the prompt and continue with installation in the normal way."
+msgid "If you do not want to configure RAID 1 mirroring, enter **No** at the prompt and continue with installation in the normal way."
 msgstr "Si no desea configurar la duplicación de RAID 1, ingrese "No" en el indicador y continúe con la instalación de la manera normal."
 
 #: ../../operation/information.rst:21

docs/_locale/ja/operation.pot

@@ -13,24 +13,24 @@ msgid "1 - Remove the failed disk from the RAID 1 set by issuing the following c
 msgstr "1 - Remove the failed disk from the RAID 1 set by issuing the following command:"
 
 #: ../../operation/raid.rst:113
-msgid "1 - To break apart the current RAID 1 set, enter “No” at the prompt. The"
+msgid "1 - To break apart the current RAID 1 set, enter **No** at the prompt. The"
-msgstr "1 - To break apart the current RAID 1 set, enter “No” at the prompt. The"
+msgstr "1 - To break apart the current RAID 1 set, enter **No** at the prompt. The"
 
 #: ../../operation/raid.rst:71
-msgid "1 - To create a new RAID 1 array, enter “Yes” at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
+msgid "1 - To create a new RAID 1 array, enter **Yes** at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
-msgstr "1 - To create a new RAID 1 array, enter “Yes” at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
+msgstr "1 - To create a new RAID 1 array, enter **Yes** at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
 
 #: ../../operation/raid.rst:162
 msgid "2- Physically remove the failed disk from the system. If the drives are not hot-swappable, then you must shut down the system before removing the disk."
 msgstr "2- Physically remove the failed disk from the system. If the drives are not hot-swappable, then you must shut down the system before removing the disk."
 
 #: ../../operation/raid.rst:123
-msgid "2 - To decline to set up a new RAID 1 configuration on the disks, enter “No” at the prompt. The system prompts you to indicate which partition you would like the system installed on."
+msgid "2 - To decline to set up a new RAID 1 configuration on the disks, enter **No** at the prompt. The system prompts you to indicate which partition you would like the system installed on."
-msgstr "2 - To decline to set up a new RAID 1 configuration on the disks, enter “No” at the prompt. The system prompts you to indicate which partition you would like the system installed on."
+msgstr "2 - To decline to set up a new RAID 1 configuration on the disks, enter **No** at the prompt. The system prompts you to indicate which partition you would like the system installed on."
 
 #: ../../operation/raid.rst:79
-msgid "2 - To overwrite the old filesystem, enter “Yes”."
+msgid "2 - To overwrite the old filesystem, enter **Yes**."
-msgstr "2 - To overwrite the old filesystem, enter “Yes”."
+msgstr "2 - To overwrite the old filesystem, enter **Yes**."
 
 #: ../../operation/raid.rst:131
 msgid "3 - Enter the partition where you would like the system installed. The system then prompts you to indicate whether you want to save the old configuration data. This represents the current VyOS configuration."
@@ -46,8 +46,8 @@ msgstr "3 - The system informs you that all data on both drives will be erased.
 
 #: ../../operation/raid.rst:88
 #: ../../operation/raid.rst:139
-msgid "4 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgid "4 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
-msgstr "4 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgstr "4 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
 
 #: ../../operation/raid.rst:167
 msgid "4 - Format the new disk for RAID 1 by issuing the following command:"
@@ -62,8 +62,8 @@ msgid "5 - Continue with installation in the normal way."
 msgstr "5 - Continue with installation in the normal way."
 
 #: ../../operation/raid.rst:96
-msgid "5 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgid "5 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
-msgstr "5 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgstr "5 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
 
 #: ../../operation/raid.rst:99
 msgid "6 - Continue with installation in the normal way."
@@ -126,8 +126,8 @@ msgid "If a device is unplugged and re-plugged it will receive a new Port, Dev,
 msgstr "If a device is unplugged and re-plugged it will receive a new Port, Dev, If identification."
 
 #: ../../operation/raid.rst:57
-msgid "If you do not want to configure RAID 1 mirroring, enter “No” at the prompt and continue with installation in the normal way."
+msgid "If you do not want to configure RAID 1 mirroring, enter **No** at the prompt and continue with installation in the normal way."
-msgstr "If you do not want to configure RAID 1 mirroring, enter “No” at the prompt and continue with installation in the normal way."
+msgstr "If you do not want to configure RAID 1 mirroring, enter **No** at the prompt and continue with installation in the normal way."
 
 #: ../../operation/information.rst:21
 msgid "In the past serial interface have been defined as ttySx and ttyUSBx where x was an instance number of the serial interface. It was discovered that from system boot to system boot the mapping of USB based serial interfaces will differ, depending which driver was loaded first by the operating system. This will become rather painful if you not only have serial interfaces for a console server connected but in addition also a serial backed :ref:`wwan-interface`."

docs/_locale/pt/operation.pot

@@ -13,24 +13,24 @@ msgid "1 - Remove the failed disk from the RAID 1 set by issuing the following c
 msgstr "1 - Remove the failed disk from the RAID 1 set by issuing the following command:"
 
 #: ../../operation/raid.rst:113
-msgid "1 - To break apart the current RAID 1 set, enter “No” at the prompt. The"
+msgid "1 - To break apart the current RAID 1 set, enter **No** at the prompt. The"
-msgstr "1 - To break apart the current RAID 1 set, enter “No” at the prompt. The"
+msgstr "1 - To break apart the current RAID 1 set, enter **No** at the prompt. The"
 
 #: ../../operation/raid.rst:71
-msgid "1 - To create a new RAID 1 array, enter “Yes” at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
+msgid "1 - To create a new RAID 1 array, enter **Yes** at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
-msgstr "1 - To create a new RAID 1 array, enter “Yes” at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
+msgstr "1 - To create a new RAID 1 array, enter **Yes** at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
 
 #: ../../operation/raid.rst:162
 msgid "2- Physically remove the failed disk from the system. If the drives are not hot-swappable, then you must shut down the system before removing the disk."
 msgstr "2- Physically remove the failed disk from the system. If the drives are not hot-swappable, then you must shut down the system before removing the disk."
 
 #: ../../operation/raid.rst:123
-msgid "2 - To decline to set up a new RAID 1 configuration on the disks, enter “No” at the prompt. The system prompts you to indicate which partition you would like the system installed on."
+msgid "2 - To decline to set up a new RAID 1 configuration on the disks, enter **No** at the prompt. The system prompts you to indicate which partition you would like the system installed on."
-msgstr "2 - To decline to set up a new RAID 1 configuration on the disks, enter “No” at the prompt. The system prompts you to indicate which partition you would like the system installed on."
+msgstr "2 - To decline to set up a new RAID 1 configuration on the disks, enter **No** at the prompt. The system prompts you to indicate which partition you would like the system installed on."
 
 #: ../../operation/raid.rst:79
-msgid "2 - To overwrite the old filesystem, enter “Yes”."
+msgid "2 - To overwrite the old filesystem, enter **Yes**."
-msgstr "2 - To overwrite the old filesystem, enter “Yes”."
+msgstr "2 - To overwrite the old filesystem, enter **Yes**."
 
 #: ../../operation/raid.rst:131
 msgid "3 - Enter the partition where you would like the system installed. The system then prompts you to indicate whether you want to save the old configuration data. This represents the current VyOS configuration."
@@ -46,8 +46,8 @@ msgstr "3 - The system informs you that all data on both drives will be erased.
 
 #: ../../operation/raid.rst:88
 #: ../../operation/raid.rst:139
-msgid "4 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgid "4 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
-msgstr "4 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgstr "4 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
 
 #: ../../operation/raid.rst:167
 msgid "4 - Format the new disk for RAID 1 by issuing the following command:"
@@ -62,8 +62,8 @@ msgid "5 - Continue with installation in the normal way."
 msgstr "5 - Continue with installation in the normal way."
 
 #: ../../operation/raid.rst:96
-msgid "5 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgid "5 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
-msgstr "5 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgstr "5 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
 
 #: ../../operation/raid.rst:99
 msgid "6 - Continue with installation in the normal way."
@@ -126,8 +126,8 @@ msgid "If a device is unplugged and re-plugged it will receive a new Port, Dev,
 msgstr "If a device is unplugged and re-plugged it will receive a new Port, Dev, If identification."
 
 #: ../../operation/raid.rst:57
-msgid "If you do not want to configure RAID 1 mirroring, enter “No” at the prompt and continue with installation in the normal way."
+msgid "If you do not want to configure RAID 1 mirroring, enter **No** at the prompt and continue with installation in the normal way."
-msgstr "If you do not want to configure RAID 1 mirroring, enter “No” at the prompt and continue with installation in the normal way."
+msgstr "If you do not want to configure RAID 1 mirroring, enter **No** at the prompt and continue with installation in the normal way."
 
 #: ../../operation/information.rst:21
 msgid "In the past serial interface have been defined as ttySx and ttyUSBx where x was an instance number of the serial interface. It was discovered that from system boot to system boot the mapping of USB based serial interfaces will differ, depending which driver was loaded first by the operating system. This will become rather painful if you not only have serial interfaces for a console server connected but in addition also a serial backed :ref:`wwan-interface`."

docs/_locale/uk/operation.pot

@@ -13,11 +13,11 @@ msgid "1 - Remove the failed disk from the RAID 1 set by issuing the following c
 msgstr "1. Видаліть несправний диск із набору RAID 1, виконавши таку команду:"
 
 #: ../../operation/raid.rst:113
-msgid "1 - To break apart the current RAID 1 set, enter “No” at the prompt. The"
+msgid "1 - To break apart the current RAID 1 set, enter **No** at the prompt. The"
 msgstr "1. Щоб розбити поточний набір RAID 1, у запиті введіть «Ні». The"
 
 #: ../../operation/raid.rst:71
-msgid "1 - To create a new RAID 1 array, enter “Yes” at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
+msgid "1 - To create a new RAID 1 array, enter **Yes** at the prompt. If the system detects a filesystem on the partitions being used for RAID 1 it will prompt you to indicate whether you want to continue creating the RAID 1 array."
 msgstr "1. Щоб створити новий масив RAID 1, у запиті введіть «Так». Якщо система виявить файлову систему на розділах, що використовуються для RAID 1, вона запропонує вам вказати, чи бажаєте ви продовжити створення масиву RAID 1."
 
 #: ../../operation/raid.rst:162
@@ -25,11 +25,11 @@ msgid "2- Physically remove the failed disk from the system. If the drives are n
 msgstr "2- Фізично видаліть несправний диск із системи. Якщо диски не підтримують гарячу заміну, перед видаленням диска необхідно вимкнути систему."
 
 #: ../../operation/raid.rst:123
-msgid "2 - To decline to set up a new RAID 1 configuration on the disks, enter “No” at the prompt. The system prompts you to indicate which partition you would like the system installed on."
+msgid "2 - To decline to set up a new RAID 1 configuration on the disks, enter **No** at the prompt. The system prompts you to indicate which partition you would like the system installed on."
 msgstr "2. Щоб відмовитися від налаштування нової конфігурації RAID 1 на дисках, у запиті введіть «Ні». Система запропонує вам вказати, на який розділ ви хочете встановити систему."
 
 #: ../../operation/raid.rst:79
-msgid "2 - To overwrite the old filesystem, enter “Yes”."
+msgid "2 - To overwrite the old filesystem, enter **Yes**."
 msgstr "2 - Щоб перезаписати стару файлову систему, введіть «Так»."
 
 #: ../../operation/raid.rst:131
@@ -46,7 +46,7 @@ msgstr "3 - Система повідомляє, що всі дані на об
 
 #: ../../operation/raid.rst:88
 #: ../../operation/raid.rst:139
-msgid "4 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgid "4 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
 msgstr "4 - Введіть «Так» у запиті, щоб зберегти поточну конфігурацію VyOS після завершення встановлення. Введіть «Ні», щоб видалити поточну конфігурацію VyOS."
 
 #: ../../operation/raid.rst:167
@@ -62,7 +62,7 @@ msgid "5 - Continue with installation in the normal way."
 msgstr "5 - Продовжте встановлення звичайним способом."
 
 #: ../../operation/raid.rst:96
-msgid "5 - Enter “Yes” at the prompt to retain the current VyOS configuration once installation is complete. Enter “No” to delete the current VyOS configuration."
+msgid "5 - Enter **Yes** at the prompt to retain the current VyOS configuration once installation is complete. Enter **No** to delete the current VyOS configuration."
 msgstr "5 - Введіть «Так» у запиті, щоб зберегти поточну конфігурацію VyOS після завершення встановлення. Введіть «Ні», щоб видалити поточну конфігурацію VyOS."
 
 #: ../../operation/raid.rst:99
@@ -126,7 +126,7 @@ msgid "If a device is unplugged and re-plugged it will receive a new Port, Dev,
 msgstr "Якщо пристрій відключити та знову підключити, він отримає новий ідентифікатор Port, Dev, If."
 
 #: ../../operation/raid.rst:57
-msgid "If you do not want to configure RAID 1 mirroring, enter “No” at the prompt and continue with installation in the normal way."
+msgid "If you do not want to configure RAID 1 mirroring, enter **No** at the prompt and continue with installation in the normal way."
 msgstr "Якщо ви не хочете налаштовувати дзеркальне відображення RAID 1, у запиті введіть «Ні» та продовжте інсталяцію звичайним способом."
 
 #: ../../operation/information.rst:21

docs/operation/boot-options.rst

@@ -1,3 +1,5 @@
+:lastproofread: 2025-11-14
+
 .. _boot-options:
 
 
@@ -5,17 +7,14 @@
 Boot Options
 ############
 
-.. warning:: This function may be highly disruptive.
+.. warning:: This function can disrupt services.
-   It may cause major service interruption, so make sure you really
+   Run it only when necessary, and verify all input values before proceeding.
-   need it and verify your input carefully.
 
 
-
+VyOS provides several kernel command-line options to modify the normal boot
-VyOS has several kernel command line options to modify the normal boot
+process.
-process. 
+To add an option, select the desired image in the GRUB menu at load time.
-To add an option, select the desired image in GRUB menu at load
+Type **e** to edit the first line, then type **Ctrl+X** to boot.
-time, press **e**, edit the first line, and press **Ctrl-x** to boot when
-ready.
 
 .. image:: /_static/images/boot-options.png
    :width: 80%
@@ -25,16 +24,17 @@ ready.
 Specify custom config file
 ==========================
 
-Tells the system to use specified file instead of ``/config/config.boot``.
+You can use a configuration file instead of the default ``/config/config.boot``
-If specified file does not exist or is not readable, fall back to
+file.
-default config. No additional verification is performed, so make sure
+If the specified file doesn't exist or isn't readable, the system uses the
-you specify a valid config file.
+default configuration file.
+No additional verification is performed, so specify a valid configuration file.
 
 .. code-block:: none
 
    vyos-config=/path/to/file
 
-To load the *factory default* config, use:
+To load the *factory default* configuration, use:
 
 .. code-block:: none
 
@@ -44,8 +44,8 @@ To load the *factory default* config, use:
 Disable specific boot process steps
 ===================================
 
-These options disable some boot steps. Make sure you understand the
+These options disable certain steps in the boot process. Understand the
-:ref:`boot process <boot-steps>` well before using them!
+:ref:`boot process <boot-steps>` before using them.
 
 .. glossary::
 

docs/operation/information.rst

@@ -1,13 +1,14 @@
-:lastproofread: 2021-07-07
+:lastproofread: 2025-11-19
 
 .. _information:
 
-***********
+******************
-Information
+System Information
-***********
+******************
 
 VyOS features a rich set of operational level commands to retrieve arbitrary
-information about your running system.
+information about your running system. For more information on the VyOS command
+line interface (CLI), see :ref:`cli`.
 
 ########
 Hardware
@@ -18,27 +19,28 @@ Hardware
 USB
 ===
 
-In the past serial interface have been defined as ttySx and ttyUSBx where x was
+In the past, serial interfaces were defined as ``ttySx`` and ``ttyUSBx`` where
-an instance number of the serial interface. It was discovered that from system
+``x`` was the instance number. However, the mapping of USB-based
-boot to system boot the mapping of USB based serial interfaces will differ,
+serial interfaces can change from one system boot to another, depending on
-depending which driver was loaded first by the operating system. This will
+which driver the operating system loads first.
-become rather painful if you not only have serial interfaces for a console
+This inconsistency can be problematic when you
-server connected but in addition also a serial backed :ref:`wwan-interface`.
+use multiple serial interfaces.
+For example, both console-server connections and a serial-backed
+:ref:`wwan-interface`.
 
-To overcome this issue and the fact that in almost 50% of all cheap USB to
+To address this issue, and because many low-cost USB-to-serial converters
-serial converters there is no serial number programmed, the USB to serial
+do not have a programmed serial number, VyOS now identifies USB-to-serial
-interface is now directly identified by the USB root bridge and bus it connects
+interfaces by the USB root bridge and the bus they connect to.
-to. This somehow mimics the new network interface definitions we see in recent
+This approach is similar to the network interface naming conventions used in
-Linux distributions.
+recent Linux distributions.
 
-For additional details you can refer to https://vyos.dev/T2490.
 
 .. opcmd:: show hardware usb
 
-  Retrieve a tree like representation of all connected USB devices.
+  Retrieve a tree-like representation of all connected USB devices.
 
-  .. note:: If a device is unplugged and re-plugged it will receive a new
+  .. note:: If a device is unplugged and plugged in again, it is assigned a new
-    Port, Dev, If identification.
+    ``Port``, ``Dev``, and ``If``.
 
   .. code-block:: none
 
@@ -72,8 +74,8 @@ For additional details you can refer to https://vyos.dev/T2490.
 .. opcmd:: show hardware usb serial
 
   Retrieve a list and description of all connected USB serial devices. The
-  device name displayed, e.g. `usb0b2.4p1.0` can be directly used when accessing
+  device name displayed, (for example ``usb0b2.4p1.0``), can be used
-  the serial console as console-server device.
+  directly when accessing the serial console as console-server device.
 
   .. code-block:: none
 
@@ -105,9 +107,8 @@ Version
 
 .. opcmd:: show version
 
-  Return the current running VyOS version and build information. This includes
+  Return the currently running VyOS version and build information. This includes
-  also the name of the release train which is ``crux`` on VyOS 1.2, ``equuleus``
+  the name of the release train, e.g., ``sagitta`` on VyOS 1.4, and ``circinus`` on VyOS 1.5.
-  on VyOS 1.3 and ``sagitta`` on VyOS 1.4.
 
   .. code-block:: none
   
@@ -134,7 +135,7 @@ Version
 
 .. opcmd:: show version kernel
 
-  Return version number of the Linux Kernel used in this release.
+  Return the version number of the currently running Linux kernel.
 
   .. code-block:: none
 
@@ -143,7 +144,7 @@ Version
 
 .. opcmd:: show version frr
 
-  Return version number of FRR (Free Range Routing - https://frrouting.org/)
+  Return the version number of FRR (Free Range Routing - https://frrouting.org/)
   used in this release. This is the routing control plane and a successor to GNU
   Zebra and Quagga.
 

docs/operation/password-recovery.rst

@@ -1,3 +1,5 @@
+:lastproofread: 2025-11-19
+
 .. _password-recovery:
 
 #################
@@ -5,14 +7,14 @@ Password Recovery
 #################
 
 Using the console, restart the VyOS router. The GRUB menu appears.
-Select the relevant option from the GRUB menu and press Enter.
+Select the relevant option from the GRUB menu, then press **Enter**.
-The option must start with “Lost password change.”
+The option must begin with *Lost password change.*
 
 .. figure:: /_static/images/password-recovery-01.png
    :width: 600
 
-The stand-alone user-password recovery tool starts running and prompts 
+The stand-alone user-password recovery tool runs and prompts you to reset the
-you to reset the local system user password.
+local system user password.
 
 .. code-block:: console
 

docs/operation/raid.rst

@@ -1,134 +1,132 @@
+:lastproofread: 2025-11-20
+
 .. _raid:
 
 ######
-RAID-1 
+RAID 1 
 ######
 
 A Redundant Array of Independent Disks (RAID) uses two or more hard disk drives 
 to improve disk speed, store more data, and/or provide fault tolerance. 
 There are several storage schemes possible in a RAID array, each offering a 
-different combination of storage, reliability, and/or performance. 
+different combination of storage, reliability, and performance.
-The VyOS system supports a “RAID 1” deployment. RAID 1 allows two or more 
+VyOS supports **RAID 1** deployments. RAID 1 uses two or more
-disks to mirror one another to provide system fault tolerance. In a RAID 1 
+disks that mirror one another to provide system fault tolerance. In a RAID 1
-solution, every sector of one disk is duplicated onto every sector of all 
+configuration, every sector on one disk is duplicated on every sector of all
 disks in the array. Provided even one disk in the RAID 1 set is operational, 
 the system continues to run, even through disk replacement (provided that the 
 hardware supports in-service replacement of drives). 
 RAID 1 can be implemented using special hardware or it can be implemented in 
-software. The VyOS system supports software RAID 1 on two disks.
+software. VyOS supports software RAID 1 on two disks.
-The VyOS implementation of RAID 1 allows the following:
+The VyOS implementation of RAID 1 features the following:
 
-* Detection and reporting of disk failure
+* Detection and reporting of disk failure.
-* The ability to maintain system operation with one failed disk
+* Maintain system operation with one failed disk.
-* The ability to boot the system with one failed disk
+* Boot the system with one failed disk.
-* The ability to replace a failed disk and initiate re-mirroring
+* Replace a failed disk and initiate re-mirroring.
-* The ability to monitor the status of remirroring
+* Monitor the status of re-mirroring.
 
 .. _raid_installation:
 
-Installation Implications
+Installation implications
 =========================
 
-The VyOS systems installation utility provides several options for installing 
+The VyOS installation utility provides several options for installing
 to a RAID 1 set. You can: 
 
-* Use the install system to create the RAID 1 set 
+* Use the install system to create the RAID 1 set.
-* Use the underlying Linux commands to create a RAID 1 set before running the 
+* Use the built-in Linux commands to create a RAID 1 set before running the
   install system command.
 * Use a previously-created RAID 1 set.
 
-.. note:: Before a permanent installation, VyOS runs a live installation
+.. note:: Before a permanent installation, VyOS runs a live installation.
 
 Configuration
 =============
 
-Single disk, install as normal 
+Standard installation on a single disk 
-------------------------------
+--------------------------------------
 
-When the VyOS system is installed, it automatically detects the presence of two 
+VyOS automatically detects the presence of two or more
-disks not currently part of a RAID array. In these cases, the VyOS 
+disks that are not currently part of a RAID array when installed. The VyOS
-installation utility automatically offers you the option of configuring RAID 1 
+installation utility automatically offers you the option to configure RAID 1
-mirroring for the drives, with the following prompt.
+mirroring for eligible drives with the following prompt:
 
 .. code-block:: none
 
    Would you like to configure RAID 1 mirroring on them?
 
-* If you do not want to configure RAID 1 mirroring, enter “No” at the prompt
+* If you do not want to configure RAID 1 mirroring, enter **No** at the prompt.
-  and continue with installation in the normal way.
 
-Empty 2+ Disk 
+Empty 2+ disk 
 -------------
 
-If VyOS system detect two identical disks that are not currently part of a 
+If VyOS detects two identical disks that are not currently part of a 
-RAID-1 set, the VyOS installation utility automatically offers you the option
+RAID 1 set, the VyOS installation utility automatically offers the option
-of configuring RAID 1 mirroring for the drives, with the following prompt. 
+to configure RAID 1 mirroring for the drives with the following prompt: 
 
 .. code-block:: none
 
    Would you like to configure RAID 1 mirroring on them? 
 
-1 - To create a new RAID 1 array, enter “Yes” at the prompt. If the system 
+1. To create a new RAID 1 array, enter **Yes** at the prompt. If VyOS 
-detects a filesystem on the partitions being used for RAID 1 it will prompt you 
+detects a filesystem on the partitions being used for RAID 1, it will prompt you 
 to indicate whether you want to continue creating the RAID 1 array. 
 
 .. code-block:: none
 
    Continue creating array?
 
-2 - To overwrite the old filesystem, enter “Yes”. 
+2. To overwrite the old filesystem, enter **Yes**. 
 
-3 - The system informs you that all data on both drives will be erased. You are 
+3. The system informs you that all data on both drives will be erased.
-prompted to confirm that you want to continue
+Confirm you want to continue.
 
 .. code-block:: none
 
    Are you sure you want to do this?
 
-4 - Enter “Yes” at the prompt to retain the current VyOS configuration once 
+4. Enter **Yes** at the prompt to retain the current VyOS configuration.
-installation is complete. Enter “No” to delete the current VyOS
+Enter **No** to delete the current VyOS configuration. 
-configuration. 
 
 .. code-block:: none
 
    Would you like me to save the data on it before I delete it?
 
-5 - Enter “Yes” at the prompt to retain the current VyOS configuration once 
+5. Enter **Yes** at the prompt to retain the current VyOS configuration.
-installation is complete. Enter “No” to delete the current VyOS configuration.
+Enter **No** to delete the current VyOS configuration.
 
-6 - Continue with installation in the normal way.
+6. Continue installing VyOS.
 
 
-Present RAID-1
+Preexisting RAID 1 configuration
---------------
+--------------------------------
 
-When the VyOS software on a system with a RAID 1 set already configured, 
+When VyOS detects a previously configured RAID 1 set,
-the installation utility will detect the array and will display the following 
+the installation utility displays the following prompt: 
-prompt: 
 
 .. code-block:: none
 
    Would you like to use this one? 
 
-1 - To break apart the current RAID 1 set, enter “No” at the prompt. The 
+1. To break up the current RAID 1 set, enter **No** at the prompt. The 
-
 installation utility detects that there are two identical disks and offers you 
-the option of configuring RAID 1 mirroring on them, displaying the following 
+the option of configuring RAID 1 mirroring with the following 
 prompt: 
 
 .. code-block:: none
 
    Would you like to configure RAID 1 mirroring on them? 
 
-2 - To decline to set up a new RAID 1 configuration on the disks, enter “No” 
+2. To decline to set up a new RAID 1 configuration on the disks, enter **No** 
-at the prompt. The system prompts you to indicate which partition you would 
+at the prompt. VyOS prompts you to indicate which partition you would 
 like the system installed on. 
 
 .. code-block:: none
    
     Which partition should I install the root on? [sda1]: 
 
-3 - Enter the partition where you would like the system installed. The system 
+3. Enter the partition where you would like the system installed. The system 
 then prompts you to indicate whether you want to save the old configuration
 data. This represents the current VyOS configuration. 
 
@@ -136,54 +134,55 @@ data. This represents the current VyOS configuration.
 
    Would you like me to save the data on it before I delete it? 
 
-4 - Enter “Yes” at the prompt to retain the current VyOS configuration once 
+4. Enter **Yes** at the prompt to retain the current VyOS configuration once 
-installation is complete. Enter “No” to delete the current VyOS configuration. 
+installation is complete. Enter **No** to delete the current VyOS configuration. 
 
-5 - Continue with installation in the normal way.
+5. Continue installing VyOS.
 
 
-Detecting and Replacing a Failed RAID 1 Disk
+Detecting and replacing a failed RAID 1 disk
 --------------------------------------------
 
-The VyOS system automatically detects a disk failure within a RAID 1 set and 
+VyOS system detects disk failures within a RAID 1 set and 
-reports it to the system console. You can verify the failure by issuing the
+reports them to the system console. You can verify the failure by running the
-show raid command.
+``show raid`` command.
 
-To replace a bad disk within a RAID 1 set, perform the following steps:
+To replace a bad disk within a RAID 1 set:
 
-1 - Remove the failed disk from the RAID 1 set by issuing the following 
+1. Remove the failed disk from the RAID 1 set:
-command:
 
-.. opcmd:: delete raid <RAID‐1‐device> member <disk‐partition>
+   .. opcmd:: delete raid <RAID‐1‐device> member <disk‐partition>
 
-   where RAID-1-device is the name of the RAID 1 device (for example, md0) and 
+   where ``RAID-1-device`` is the name of the RAID 1 device. For example, 
-   disk-partition is the name of the failed disk partition (for example, sdb2).
+   ``md0`` and 
+   ``disk-partition`` is the name of the failed disk partition. For example,
+   ``sdb2``.
 
-2- Physically remove the failed disk from the system. If the drives are not 
+2. Physically remove the failed disk from the system. If the drives are not 
-hot-swappable, then you must shut down the system before removing the disk.
+   hot-swappable, then you must shut down the system before removing the disk.
 
-3 - Replace the failed drive with a drive of the same size or larger.
+3. Replace the failed drive with a drive of the same size or larger.
 
-4 - Format the new disk for RAID 1 by issuing the following command:
+4. Format the new disk for RAID 1 by running the following command:
 
-.. opcmd:: format disk <disk‐device1> like <disk‐device2>
+   .. opcmd:: format disk <disk‐device1> like <disk‐device2>
 
-   where disk-device1 is the replacement disk (for example, sdb) and 
+   where ``disk-device1`` is the replacement disk. For example, ``sdb`` and 
-   disk-device2 is the existing healthy disk (for example, sda).
+   ``disk-device2`` is the existing healthy disk. For example, ``sda``.
 
-5-Add the replacement disk to the RAID 1 set by issuing the following command:
+5. Add the replacement disk to the RAID 1 set by running the following command:
 
-.. opcmd:: add raid <RAID‐1‐device> member <disk‐partition>
+   .. opcmd:: add raid <RAID‐1‐device> member <disk‐partition>
 
-   where RAID-1-device is the name of the RAID 1 device (for example, md0) and 
+   where ``RAID-1-device`` is the name of the RAID 1 device. For example,
-   disk-partition is the name of the replacement disk partition 
+   ``md0`` and ``disk-partition`` is the name of the replacement disk partition.
-   (for example, sdb2).
+   For example, ``sdb2``.
 
 Operation
 =========
 
-This part introduces how to add a disk partition to a RAID-1 set initiates
+Learn how to add a disk partition to a RAID 1 set, initiate
-mirror synchronization, check and display information.
+mirror synchronization, and check and display information.
 
 .. opcmd:: add raid <RAID‐1‐device> member <disk‐partition>
  
@@ -194,11 +193,11 @@ mirror synchronization, check and display information.
 .. opcmd:: format disk <disk‐device1> like <disk‐device2>
 
    This command is typically used to prepare a disk to be added to a preexisting
-   RAID 1 set (of which disk-device2 is already a member).
+   RAID 1 set (of which ``disk-device2`` is already a member).
 
 .. opcmd:: show raid <RAID‐1‐device>
    
-   shows output for show raid md0 as sdb1 is being added to the RAID 1 
+   shows output for ``show raid md0`` as ``sdb1`` is being added to the RAID 1 
    set and is in the process of being resynchronized.
 
    .. code-block:: none
@@ -227,7 +226,7 @@ mirror synchronization, check and display information.
            0       8        1        0      active sync   /dev/sda1
            2       8       17        1      spare rebuilding   /dev/sdb1
 
-.. opcmd:: show raid <RAID‐1‐device>
+.. opcmd:: show disk sda format
    
    Use this command to display the formatting of a hard disk.
 

docs/operation/upgrade-recovery.rst

@@ -1,3 +1,5 @@
+:lastproofread: 2025-11-20
+
 .. _upgrade_recovery:
 
 
@@ -5,20 +7,21 @@
 Recovery after Failed Upgrades
 ##############################
 
-This section explains **VyOS’s upgrade recovery**, which restores the system to the last working version after a failed upgrade. It covers the following points:
+Use **VyOS upgrade recovery** to restore the system to the last working
+version after a failed upgrade.
 
 * :ref:`Configuration:  <configuration>` How to enable upgrade recovery
-* :ref:`How it Works: <how_it_works>` Overview of the recovery process
+* :ref:`How it works: <how_it_works>` Overview of the recovery process
-* :ref:`Cancelling Recovery: <cancelling_recovery>` Overview of the recovery process
+* :ref:`Cancelling recovery: <cancelling_recovery>` Overview of the recovery
+  process
  
-
-
 .. _configuration:
 
 *************
 Configuration
 *************
-.. warning:: Upgrade recovery is disabled by default. To use it, **enable it first**.
+.. warning:: Upgrade recovery is disabled by default. To use it, 
+  **enable it first**.
 
 To enable upgrade recovery, run the following command:
 
@@ -26,14 +29,18 @@ To enable upgrade recovery, run the following command:
 
    set system option reboot-on-upgrade-failure [timeout <min>]
 
-* ``timeout <min>:`` The time in minutes (from 5 to 30) you have to cancel upgrade recovery. See :ref:`Cancelling Recovery <cancelling_recovery>`.
+* ``timeout <min>:`` The time in minutes (5 - 30) to cancel upgrade
+  recovery before VyOS reboots.
+  See :ref:`Cancelling Recovery <cancelling_recovery>`.
  
 .. _how_it_works:
 
 ************
-How it Works
+How it works
 ************
-After a VyOS upgrade, the system monitors the boot process. Upon detecting a boot failure, VyOS initiates a revert to the last working version and displays the following warning:
+After a VyOS upgrade, the system monitors the boot process. Upon detecting a
+boot failure, VyOS initiates a revert to the last working version and displays
+the following warning:
 
 .. code-block:: none
 
@@ -41,7 +48,8 @@ After a VyOS upgrade, the system monitors the boot process. Upon detecting a boo
    Automatic reboot in xx minutes
    Use "reboot cancel" to cancel
 
-If no action is taken, the reboot happens automatically after the configured timeout. Upon successful recovery and reboot, the following message appears: 
+If no action is taken, the reboot happens automatically after the configured
+timeout. Upon successful recovery and reboot, the following message appears: 
  
 .. code-block:: none
 
@@ -53,9 +61,11 @@ If no action is taken, the reboot happens automatically after the configured tim
 .. _cancelling_recovery:
 
 *******************
-Cancelling Recovery
+Cancelling recovery
 *******************
-Upon detecting a boot failure, you have the predefined timeout to cancel upgrade recovery. This is useful if you want to troubleshoot the faulty VyOS version on your own.
+Upon detecting a boot failure, you have the predefined timeout to cancel
+upgrade recovery. This is useful if you want to troubleshoot the faulty VyOS
+version on your own.
 
 To cancel upgrade recovery, run the following command: