Comments 3
Да документация это такая сложная штука как и код который документация описывает.
Если документация тоже такая же интерактивнгая как и сам код это тоже современный вариант. Современный или не современный вариант документации, главное чтобы читая документацию было всё понятно для разработчика.
Улучшение документации хороший вариант для привлечения людей к своему продукту и интерактивность этому не исключение. Но так же совмещение хорошего продукта с хорошей документацией вот залог лучшего продукта чем просто лучшая документация.
Для такой работы лучше привлекать профессионалов, а написание простого кода оставить таким же простым программистам.
Подытожив можно сказать что каждому делу найдётся свой специалист и не страшно что ты простой программист и пишешь простой код (такие специалисты тоже нужны, но развиваться тоже всегда нужно так как сфера IT меняется постоянно).
Да блин. Где конкретика? Как вы используете мдх? Какой у вас гитфлоу, который учитывает и документацию и код? Как именно вы используете плейрайт для создания скриншотов? Куда эти скриншоты попадают? Прямо в документацию? Кто и как с этими скриншотами работает? Что именно вы покрываете документацией? Только компоненты? Что насчёт комплексных фичей, целых экранов, api? Какие ИИ инструменты вы используете для генерации документации? Как вы их используете?
ChatGPT напиши статью про фронтед документацию, состоящую исключительно из воды и эпитетов, не включая ни строчки смысловой нагрузки.
От живых гайдлайнов к Documentation as Code. Как изменилась документация во фронтенд-разработке