"⚛️ Генезис: Duo - файлы Немного теории Когда мы с вами обсуждаем некие подходы и приёмы, рассматраиаемый подход доносится в форме: ""делайте Х, получите Y"". Но что отличает информацию от знаний? Глубина понимания, владения и осознавания - как именно эта информация встраивается в реальность. И как достигать глубины понимания информации - работать с ней! Например, провести первичное позиционирование. Когда видим ""делайте Х"", важно понимать - в каком контексте обсуждается утверждение. При каких условиях это работает. Также будет здорово понимать историю вопроса - а что привело к понимают, что надо ""делать Х""? А какие опции ещё есть, помимо ""делать Х"", что будет если делать немного/сильно иначе? И если мы знаем ответы на подобные вопросы, то наше владение темой усиливается, и информация из категории простого набора токенов начинает перетекать в категорию знаний. Фиксирует же процесс превращения информации в знания только опыт. К нашему кейсу Итак, я могу сообщить только ифномрацию. Давайте попробуем дополнительно проработать концепцию ""duo"" файлов, чтобы чуть чуть приблизит её к знаниям. ▶️ Итак - откуда возникла потребность в duo файлах? очевидно, что из необходимости хранить библиотеки знаний о проекте. Некая документация по подсистемам разрасталась, и местам начинала дублироваться. Многословность моделей способствует быстрому росту документации, при этом она не становится ясной или понятной. Думаю, вы встречались с этим явлением. Вызод: дробление документации на максимально чёткие топики, что получило отражение в ""атомарном"" файле. Так проще заставить модель быть лаконичной. ▶️ Дополнительный плюс: контекст под задачу можно собрать только из нужной информации, выбрав интересующие концепции. ▶️ Зачем разбивка на 2 файла? Это минимальная вариация на тему ""Оглавление + саммари"" - ""текст"". То есть ""общий обзор"" - ""детали"". такая разбивка позволяет дать либо обзорный файл там, где требуется просто упомянуть концепцию, либо добавить гайдфайл для деталей. ▶️ А почему только 2 файла если мы арх-файл это ""оглавление""? Потому что мы описываем одну концепцию, и обычно не требуется большого массива данных в гайдфайлах. ▶️ Почему в двух разных папках? Дополнительная семантика - модель видит папку Architecture/ в пути к файлу, и у неё уже складывается определённое осознание типа контента в ней. Аналогично про guides. Я проводил эксперимент когда все файлы в папке duo/ - тоже норм, редактировать удобнее когда файлы рядом. Немного больше файл index, но так у нас их будет два, значит не недостаток. Сам список файлов немного засорён парами файлов, не так очевиден список концепций - но всегда можно смотреть на более удачно отформатированный индексный файл, чем в файловую систему. В общем, можно и так, на применимость подхода особо не влияет. #post @deksden_notes"