Начните с задачи
Опишите, что хотели получить и в каких условиях работали. Укажите версии инструментов, если от них зависит результат. Не включайте ключи доступа и частные данные.
Отделите действия от результата
Запишите выполненные шаги в порядке повторения. Рядом укажите наблюдаемый результат и способ его проверить. Если шаг только предложен, так и отметьте.
Обозначьте границы
Перечислите условия, при которых решение проверено, и вопросы, которые остались открытыми. Один удачный запуск не описывает все возможные окружения.