Update docs

Author: devdotnetorg

Create-extension.md

@@ -5,3 +5,8 @@
 2. npm install -g yo generator-code
 
 3. Create App: yo code
+
+Links:
+
+- Topic - [Your First Extension](https://code.visualstudio.com/api/get-started/your-first-extension);
+- [Creating Extensions for Visual Studio Code A Complete Guide - Syncfusion Blogs](https://www.syncfusion.com/blogs/post/creating-extensions-for-visual-studio-code-a-complete-guide.aspx/amp).

ISSUES_ru.md

@@ -1,9 +1,7 @@
 # Известные проблемы
 
-1. Пользовательский интерфейс расширения не соответствует [UX Guidelines](https://code.visualstudio.com/api/ux-guidelines/overview).
+1. Пользовательский интерфейс расширения частично не соответствует [UX Guidelines](https://code.visualstudio.com/api/ux-guidelines/overview).
 
-2. Долго создается профиль устройства.
+2. Медленно выполняются команды.
 
-3. Медленно выполняются команды.
-
-4. Низкая скорость выполнения bash скриптов.
+4. Низкая скорость выполнения bash-скриптов.

README_ru.md

@@ -91,8 +91,8 @@
 
 ## Тестирование
 
-Тестирование выполнялось на одноплатных компьютерах:
+Тестирование выполняется на следующих одноплатных компьютерах:
 
-- [Cubieboard](https://github.com/devdotnetorg/Cubieboard "Cubieboard")
-- [Cubietruck](https://devdotnet.org/post/otladochnaya-plata-cubietruck/ "Cubietruck")
-- [Banana Pi BPI-M64](https://devdotnet.org/post/otladochnaya-plata-banana-pi-bpi-m64/ "Banana Pi BPI-M64")
+- [Cubieboard](https://github.com/devdotnetorg/Cubieboard "Cubieboard"). Дистрибутив Armbian.
+- [Cubietruck](https://devdotnet.org/post/otladochnaya-plata-cubietruck/ "Cubietruck"). Дистрибутив Armbian.
+- [Banana Pi BPI-M64](https://devdotnet.org/post/otladochnaya-plata-banana-pi-bpi-m64/ "Banana Pi BPI-M64"). Дистрибутив Armbian.

SCHEDULE_ru.md

@@ -3,10 +3,10 @@
 - Соответствие UX Guidelines.
 - Добавление WebView для выбора шаблона проекта.
 - Пользовательские пакеты установки.
-- Пользовательские скрипты BASH для запуска на устройстве и ПК.
+- Пользовательские bash-скрипты для запуска на устройстве и ПК.
 - GPIO: чтение chips, просмотр линии gpio, управление I/O.
 - Поддержка Python проектов.
-- Обеспечение работы в Linux.
+- Обеспечение работы расширения в Linux.
 - Отображение доступных устройств: `/dev/*` и sysfs.
 - Сканер устройств I2C.
 - Добавление менеджера Nuget-пакетов.

docs/Getting-started_ru.md

@@ -16,8 +16,6 @@ apt-get install -y sudo
 ```bash
 sudo apt-get update
 sudo apt-get install -y openssh-server mc
-sudo systemctl reload ssh
-sudo systemctl status ssh
 sudo mcedit /etc/ssh/sshd_config
 ```
 
@@ -61,7 +59,7 @@ sudo systemctl status ssh
 
 ### Шаг 3 — Установка пакетов
 
-Для запуска .NET IoT приложения и выполнения удаленной отладки необходимо установить:
+Для запуска .NET IoT приложении и выполнения удаленной отладки необходимо установить:
 
 - Среду исполнения - .NET Runtime;
 - Удаленный отладчик - .NET Debugger (vsdbg).

docs/Launch-title-template_ru.md

@@ -4,6 +4,6 @@
 
 Пример слияния: `Launch on cubieboard (DotnetConsoleBlinkLEDApplication, Cubieboard, debugvscode)`.
 
-Переменные для создания названия конфигурации Launch и их значения можете посмотреть на странице [Project Templates](Project-templates_ru.md "Project Templates").
+Переменные для создания названия конфигурации Launch и их значения смотрите на странице [Project Templates](Project-templates_ru.md "Project Templates").
 
 Если вам нужны дополнительные переменные, создайте [ISSUE](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/issues "ISSUE").

docs/Project-templates_ru.md

@@ -25,7 +25,9 @@
 
 ### Папка - storage
 
-Могут размещаться любые файлы. В частности, в папке каждого шаблона размещаются утилиты **cwRsync** и **ssh** используемые для удаленного входа на устройство и копирования исполняемых бинарных фалов. По желанию можно заменить пакет, загрузив с официального сайта по [ссылке](https://itefix.net/cwrsync "ссылке").
+Могут размещаться любые файлы. Например, утилиты **cwRsync** и **ssh**, используемые для удаленного входа на устройство и копирования исполняемых бинарных фалов. По желанию можно заменить пакет, загрузив с официального сайта по [ссылке](https://itefix.net/cwrsync "ссылке").
+
+Для исключения лишнего увеличения размера шаблона утилиты **cwRsync** и **ssh** были перенесены в [каталог системных приложений](/windows/apps/). Теперь нет необходимости дублировать укзанные утилиты для каждого шаблона. Достаточно указать в шаблоне путь к системным утилитам, например: "%{extension.apps.builtin.aswindows}\\\\cwrsync\\\\ssh.exe".
 
 ### Папка - template
 
@@ -206,8 +208,10 @@
 6. "%{project.path.relative.aswindows}" => "\\\\nested".
 7. "%{project.path.full.ascygdrive}" => "/cygdrive/d/Anton/Projects/Tests/DotnetConsoleAppTestNested/nested".
 
+Если вам нужны дополнительные переменные, создайте [ISSUE](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/issues "ISSUE").
+
 ## Отладка шаблона
 
 Все ошибки связанные с проверкой шаблона будут отображены в окне OUTPUT.
 
-Если возникнет ошибка валидации структуры JSON, то в окне OUTPUT отобразится позиция в файле, которая вызвала ошибку. В этом случае исходный файл останется неизменным, а будет создан новый с именем `debug_launch_json.txt` или `debug_tasks_json.txt` в каталоге проекта.
+Если возникнет ошибка валидации структуры JSON, то в окне OUTPUT отобразится позиция в файле, которая вызвала ошибку. В этом случае исходный файл останется неизменным, и будет создан новый с именем `debug_launch_json.txt` или `debug_tasks_json.txt` в каталоге проекта.

docs/Troubleshooting_ru.md

@@ -62,6 +62,8 @@ sudo reboot now
 
 При подключение к устройству проверьте логин и пароль. Эти же реквизиты должны пройти проверку при локальном входе на устройстве. Проверьте доступность порта `22` используя терминал удаленного подключения, например [MobaXterm](https://mobaxterm.mobatek.net/download.html "MobaXterm Xserver with SSH, telnet, RDP, VNC and X11").
 
+Если проблема не была решена, то переходите к следующему разделу.
+
 **Проблемы с конфигурационными файлами**
 
 Конфигурационные файлы OpenSSH сервера располагаются в папке `/etc/ssh`. Откройте конфигурационный файл `/etc/ssh/sshd_config` OpenSSH сервера и проверьте настройки:
@@ -92,15 +94,15 @@ sudo apt-get install -y openssh-server
 sudo systemctl status ssh
 ```
 
-Не забудьте добавить строки в файл `/etc/ssh/sshd_config`:
+Не забудьте добавить в файл `/etc/ssh/sshd_config` строки:
 
 ```bash
 PermitRootLogin yes
 PasswordAuthentication yes
 ChallengeResponseAuthentication yes
 AuthenticationMethods publickey keyboard-interactive password
 ```
-И перезапустить OpenSSH сервер командой: `sudo systemctl status ssh`.
+И перезапустить OpenSSH сервер командой: `sudo systemctl reload ssh`. Затем посмотрите состояние работы OpenSSH сервера, командой: `sudo systemctl status ssh`.
 
 Если возникнут проблемы с конфигурационными файлами, то выполните следующие действия:
 
@@ -110,9 +112,9 @@ sudo dpkg --configure openssh-server
 sudo apt-get install -f
 ```
 
-Возможно проблемы с алгоритмом ключа, можете изменить используемый алгоритм для генерации ключа и его длину в настройках расширения.
+Если проблема не была решена, то возможно проблема связана с алгоритмом ключа, который используется для управления устройством и выполнения удаленной отладки. Можете изменить используемый алгоритм для генерации ключа и его длину в настройках расширения.
 
-Если так и не удалось решить проблему, то создавайте [Issue](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/issues).
+Если так и не удалось решить проблему, то создавайте [Issue](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/issues). У меня все идеи на этот счет закончились 🍨.
 
 ## Устранение неполадок при выполнении bash-скриптов на устройстве
 
@@ -170,7 +172,7 @@ chmod +x vscode-dotnetfastiot.sh
 
 Если после перезапуска расширения проблемы остались, то возможно проблемы связаны с предоставлением прав доступа к выше указанным папкам.
 
-Исполняемые файлы расширения располагются в папке `%USERPROFILE%\.vscode\extensions`, например `C:\Users\Anton\.vscode\extensions`. Вы можете удалить расширение из указанно папки и заново его установить.
+Исполняемые файлы расширения располагаются в папке `%USERPROFILE%\.vscode\extensions`, например `C:\Users\Anton\.vscode\extensions`. Вы можете удалить расширение из указанной папки и заново его установить.
 
 ## Проблема с загрузкой системных шаблонов