В общении с ИИ-помощниками я перешёл почти на телеграфный код (пример на скринах).

Никаких подводок и подсказок. Никаких «хочешь, я переведу этот текст на язык индийского танца?». Никаких «спасибо-пожалуйста». Только выжатая досуха информация и практические примеры. Это позволяет изучать новое за минуты и часы вместо дней и недель.

В чатах я так делаю уже много месяцев, но только недавно догадался сделать то же самое в документации к проектам.

Одной из постоянных проблем с ИИ-разработкой была рассинхронизация документации.

Хорошая документация для ИИ — конкретные, исполнимые (actionable) инструкции, без воды и лишних грамматических формальностей. В этих инструкциях я опускаю артикли, точки и прочие необязательные вещи, если они не влияют на смысл — это важно для контекстной гигиены, чтобы окно внимания модели как можно дольше не «расползалось».

А инструкции для людей должны быть написаны нормальным языком: полными предложениями, с пояснениями и связками-переходами от одной темы к другой. Так ведь?

На самом деле нет.

«ИИшная» документация и для человеческого меня оказалась эффективнее «литературщины». Поначалу непривычно, но потом оказывается, что так ты можешь за секунды схватить огромный объём информации, быстрее вникнуть в код и разобраться.

Пишите документацию для роботов! А люди приноровятся 🙃