Файлы: чем что открывать
Разобраться, какой формат под что заводят, и перестать держать правила там, откуда их не прочитать.
Разобраться один раз, какой формат под что заводят, и перестать держать рабочие правила там, откуда их никто не прочитает.
В работе с агентом постоянно всплывают расширения, которые в обычной офисной жизни не встречаются. Разобраться стоит один раз: дальше понятно, куда что класть.
Markdown: текст, который читают и человек, и модель
Обычный текстовый файл с очень простой разметкой. Решётка в начале строки делает заголовок, дефис делает пункт списка, две звёздочки делают жирный. Всё. Никаких скрытых настроек, никакой специальной программы: подойдёт даже Блокнот.
Почему в нём удобно держать правила и заметки: история версий показывает построчно, что изменилось, модель читает файл как есть, и через десять лет он всё так же откроется.
HTML: страница для браузера
Файл, который браузер показывает как страницу: со шрифтами, цветами, кнопками и схемами. Страница, которую вы сейчас читаете, и есть один такой файл.
Берут его тогда, когда результат надо показать и полистать: дашборд, разбор, учебный материал. HTML не правят как документ, его собирают целиком и обновляют целиком.
Куда что класть
| Формат | Для чего | Видно ли изменения в истории версий |
|---|---|---|
.md |
Правила, методики, заметки, документация | Да, построчно |
.html |
Страницы и дашборды, которые смотрят в браузере | Да, но читать неудобно |
.py |
Скрипты: разобрать выписку, пересчитать, собрать файл | Да, построчно |
.xlsx |
Финмодели и расчёты, которые дальше правит человек | Нет, только «файл изменился» |
.docx, .pptx, .pdf |
То, что уходит заказчику: договор, дек, отчёт | Нет, только «файл изменился» |
Всё, что описывает как работать, пишется в .md. Всё, что считает, живёт в .xlsx.
Всё, что показывают, собирается в .html. Наружу уходит .docx, .pdf или .pptx,
потому что так привычно получателю.
Почему это не вкусовщина
Текстовые форматы дают построчное сравнение версий, бинарные его не дают. Практическое
следствие простое: правило, лежащее в .md, можно обсуждать по строкам, откатывать
и принимать частями. То же правило в .docx превращается в «файл изменился, разбирайтесь
сами».
Отсюда порядок: внутренняя кухня текстовая, бинарные форматы появляются на последнем шаге, когда результат уходит человеку.
Вы можете сказать про любой свой рабочий файл, в каком он должен быть формате и почему,
и хотя бы одно рабочее правило переехало из документа в .md.
Что сделать
Результат: Одно рабочее правило, переехавшее из документа в текстовый файл.