Разработчик заплатил людям, чтобы они протестировали его документацию

Многие программисты пишут инструкции «для галочки», забывая про ошибки и очевидные для автора, но непонятные для новичка детали. Чтобы исправить это, разработчик ActivityBot нанял добровольцев за 25 евро в час для проверки своего README.

Формат был простым: участники включали демонстрацию экрана и вслух комментировали свои действия, а автор фиксировал все затыки и вопросы.

Основные инсайты:
• Ссылки на демо-инструменты часто ведут в никуда.
• Технический сленг и «очевидные» команды сбивают с толку.
• Юмор в документации часто только мешает.
• Структура разделов бывает нелогичной.
• Пользователи не понимают, зачем вообще нужно это ПО.

Живое общение с людьми оказалось эффективнее любого ИИ: эмоции и реальные вопросы помогли сделать инструкцию по-настоящему понятной.

рекомендуем:
@EsquireJournalRussia