Как задавать технический вопрос по ArduPilot так, чтобы на него можно было ответить

Почему большая часть слабых вопросов не дает результата

Проблема не в том, что люди не хотят помогать. Проблема в том, что по короткому описанию вроде:

  • «не армится»;
  • «плохо летит»;
  • «странно работает GPS»;
  • «не идет телеметрия»;

почти невозможно понять реальную причину.

Что должен включать хороший вопрос

Минимальный полезный состав:

  • тип аппарата;
  • модель или тип контроллера;
  • версия ArduPilot;
  • чем подключались: USB, telemetry, radio;
  • точный симптом;
  • когда именно он проявляется;
  • что уже проверено;
  • лог и параметры, если они есть;
  • точный текст предупреждения, если оно было.

Почему важно указывать момент проявления

Одинаковый симптом в разных фазах полета означает разные диагностические маршруты.

Например:

  • проблема при подключении;
  • проблема при arm;
  • проблема при взлете;
  • проблема в AUTO;
  • проблема в RTL;
  • проблема только после нескольких минут полета.

Без этого контекста ответы обычно превращаются в угадывание.

Какие артефакты особенно полезны

Наиболее ценные вложения:

  • BIN;
  • .param;
  • TLOG;
  • скриншот pre-arm или статуса;
  • фото компоновки и подключения;
  • короткое описание, что менялось перед проблемой.

Что лучше не делать

  • не писать вопрос без указания версии и типа аппарата;
  • не прикладывать только фото экрана без текста;
  • не пересказывать предупреждение своими словами, если можно привести его точно;
  • не скрывать, что аппарат падал, переделывался или работает на спорном железе.

Почему это важно

Любая сильная база знаний должна не только отвечать на вопросы, но и учить пользователей приносить качественные кейсы. Это нужно и для людей, и для качественного разбора проблем:

  • меньше мусорных обращений;
  • выше шанс на точный ответ;
  • легче превращать кейсы в новые FAQ и troubleshooting pages.

Минимальный шаблон вопроса

Хороший формат:

  1. Тип аппарата и контроллер.
  2. Версия прошивки.
  3. Точный симптом.
  4. Когда он проявляется.
  5. Что уже проверено.
  6. Какие файлы приложены.

Первоисточники

  • ArduPilot Documentation Overview: https://ardupilot.org/ardupilot/
  • Downloading and Analyzing Data Logs in Mission Planner: https://ardupilot.org/dev/docs/common-downloading-and-analyzing-data-logs-in-mission-planner.html