расширению этого плана? На что обратить внимание в первую очередь?
Вот сам план:
Установка и настройка инструментов для работы с Docs-as-Code, таких как Sphinx, MkDocs или Jekyll.
Основы Markdown и ReStructuredText: синтаксис, основные элементы и форматирование текста.
Создание и редактирование документов с использованием Markdown или ReStructuredText.
Публикация документов на веб-сервере с использованием инструментов, таких как MkDocs, Jekyll или GitHub Pages.
Использование системы управления версиями Git для контроля изменений в документах.
Работа с шаблонами и стилями для оформления документов в Docs-as-Code.
Интеграция с системами контроля качества кода, такими как Pylint или Flake8, для проверки синтаксиса и структуры документов.
Использование систем контроля версий для совместной работы над документами.
Разработка и использование плагинов для расширения функциональности Docs-as-Code.
Применение методологии Agile для управления проектами и разработки документации.
Анализ и оптимизация производительности и доступности документов с Docs-as-Code.
Pandoc; PlantUML (если нужны диаграммы).
Mermaid сюда же, раз уж GPT вспомнила про разные SSG.
На первый взгляд не хватает куска про ci/cd хотя бы в паре простых вариантов типа Gitlab ci GitHub Workflows понимание как в целом такие пайплайны могут быть устроены и зачем
Обсуждают сегодня