docs: add solution for HTTP/2 network errors on px4-autopilot clone (#…

…509) * docs(ru): add solution for HTTP/2 network errors on px4-autopilot clone * docs(en): add solution for HTTP/2 network errors on px4-autopilot clone * docs(ru): fix typo in px4-autopilot clone note * docs(ru): fix markdownlint * docs(en): fix markdownlint * Fix markdownlint --------- Co-authored-by: Oleg Kalachev <[email protected]>
CopterExpress · Sep 6, 2024 · 58ec568 · 58ec568
1 parent 28e8970
commit 58ec568
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 0 deletions.
diff --git a/docs/en/simulation_native.md b/docs/en/simulation_native.md
@@ -74,6 +74,10 @@ ln -s ~/PX4-Autopilot/mavlink ~/catkin_ws/src/
 
 > **Hint** You may use more recent PX4 version, but there would be more risk of something would not be working.
 
+<!-- -->
+
+> **Note** If clone fails with network error (`fatal: fetch-pack: invalid index-pack output`), set HTTP version 1.1 using `git config --global http.version HTTP/1.1` command (don't forget to return it back after clone using `git config --global http.version HTTP/2`). Alternative solution is cloning the repository and submodules through SSH using `git config --global url."[email protected]:".insteadOf https://github.com/` command (requires setting up valid SSH key in GitHub profile settings).
+
 ## Install PX4 prerequisites
 
 PX4 comes with its own script for dependency installation. We may as well leverage it:

diff --git a/docs/ru/simulation_native.md b/docs/ru/simulation_native.md
@@ -74,6 +74,10 @@ ln -s ~/PX4-Autopilot/mavlink ~/catkin_ws/src/
 
 > **Hint** Вы можете использовать более позднюю версию PX4 с большим риском, что что-то не заработает.
 
+<!-- -->
+
+> **Note** Если процесс клонирования завершится с ошибкой сети (`fatal: fetch-pack: invalid index-pack output`), используйте версию HTTP 1.1 `git config --global http.version HTTP/1.1` (после клонирования верните 2 версию командой `git config --global http.version HTTP/2`). Альтернативным решением будет принудительное клонирование репозитория и субмодулей через SSH командой `git config --global url."[email protected]:".insteadOf https://github.com/` (требует генерации и установки SSH ключа в настройках профиля GitHub).
+
 ## Установка зависимостей PX4
 
 PX4 имеет свой собственный скрипт для установки зависимостей. Воспользуемся им: