VS
Ага, например пандок-фильтры :) Мы думали одно время перетащить препроцессорную обработку туда и нормализировать пандоком предварительно в плейн-маркдаун, но как-то не пошло
А, погоди, т.е. в случае с MkDocs будет цепочка Pandoc -> MkDocs?
Size: a a a
2020 December 05
KV
VS
Звучит правильно)
KV
Надо подумать ещё раз, но это достаточно масштабный рефакторинг
PD
С позволения @factorized
Техническая документация – Набор информационных материалов, описывающих разные аспекты
* создания
* внутреннего устройства
* и эксплуатации
технической системы
В этом понимания слова, раздел базы знаний про use case'ы, это документация, которая чуть-чуть про каждый аспект. Она нужна, чтобы
* разраб прочитал и сделал
* тестировщик понял и проверил
* менеджер знал, как передавать в эксплуатацию (на базе кейсов, например, он может заказать написание справки)
Техническая документация – Набор информационных материалов, описывающих разные аспекты
* создания
* внутреннего устройства
* и эксплуатации
технической системы
В этом понимания слова, раздел базы знаний про use case'ы, это документация, которая чуть-чуть про каждый аспект. Она нужна, чтобы
* разраб прочитал и сделал
* тестировщик понял и проверил
* менеджер знал, как передавать в эксплуатацию (на базе кейсов, например, он может заказать написание справки)
Спасибо, но для разной документации в проекте нужны разные процессы, так что из того, что все 'документация' (а туда входят в это определении и все скрипты, например) не следует, что ее всю нужно делать одним способом.
VS
Спасибо, но для разной документации в проекте нужны разные процессы, так что из того, что все 'документация' (а туда входят в это определении и все скрипты, например) не следует, что ее всю нужно делать одним способом.
Что такое "разные процессы"?
PD
Разные роли, разные согласования, разная скорость реакции и т.п.
Пропускать вообще все через VCS+сборку неудобно. Да и сборка нужна разная, данные разные и т.п.
Пропускать вообще все через VCS+сборку неудобно. Да и сборка нужна разная, данные разные и т.п.
PD
В wiki есть огромный плюс в сравнении с системой сборки теста.
VS
В wiki есть огромный плюс в сравнении с системой сборки теста.
Какой плюс?
PD
Простота редактирования, скорость получения результата. А уж в Вики с WYSIWYG редактором и текста и диаграмм - вообще все прекрасно.
Цель wiki класса конфлюенс - доступность для всей компании вплоть до уборщицы.
Цель wiki класса конфлюенс - доступность для всей компании вплоть до уборщицы.
VS
Простота редактирования, скорость получения результата. А уж в Вики с WYSIWYG редактором и текста и диаграмм - вообще все прекрасно.
Цель wiki класса конфлюенс - доступность для всей компании вплоть до уборщицы.
Цель wiki класса конфлюенс - доступность для всей компании вплоть до уборщицы.
Простоту редактирования дают онлайн-IDE, встроенные в ваш любимый сервис для VCS.
Диаграммы - тот же PlantUML в Gitlab'е
Скорость получения результата - настройка инкрементальной сборки
Диаграммы - тот же PlantUML в Gitlab'е
Скорость получения результата - настройка инкрементальной сборки
VS
Не знаю насчёт уборщиц, а дизайнер у нас научилась жать кнопку "Edit", хотя ей никто не показывал, что такая фича вообще есть
H
ID:0
Гильдии в Plesk, Xsolla, Miro, РТ МИС и Сбере.
Ребята из разных компаний делятся опытом внутренних гильдий, то есть профессиональных сообществ. Только что сам начал смотреть, ничего не напишу в анонсе. Но гильдии — это отличная тема. У нас их аж несколько: QA, devops, frontend, backend, security, accessibility.
Судя по набору компаний, будет чертовски интересно. Рекомендую.
https://youtu.be/rCgXq1i4D9E
Ребята из разных компаний делятся опытом внутренних гильдий, то есть профессиональных сообществ. Только что сам начал смотреть, ничего не напишу в анонсе. Но гильдии — это отличная тема. У нас их аж несколько: QA, devops, frontend, backend, security, accessibility.
Судя по набору компаний, будет чертовски интересно. Рекомендую.
https://youtu.be/rCgXq1i4D9E
Хм. Интересно, одному мне при прочтении «гильдии» немедленно вспомнился старый, добрый WoW?
VA
Простоту редактирования дают онлайн-IDE, встроенные в ваш любимый сервис для VCS.
Диаграммы - тот же PlantUML в Gitlab'е
Скорость получения результата - настройка инкрементальной сборки
Диаграммы - тот же PlantUML в Gitlab'е
Скорость получения результата - настройка инкрементальной сборки
Есть много диаграмм, которые нарисовать в генерируемом виде и без использования элементов графического дизайна — сложно!
PD
Простоту редактирования дают онлайн-IDE, встроенные в ваш любимый сервис для VCS.
Диаграммы - тот же PlantUML в Gitlab'е
Скорость получения результата - настройка инкрементальной сборки
Диаграммы - тот же PlantUML в Gitlab'е
Скорость получения результата - настройка инкрементальной сборки
Хм, там wysiwyg или что-то еще? Людям, увы, нужно именно оно и не хуже ворда (
Инкрементальная сборка - это уже не "нажал кнопку и увидел"
Ну и нужны инструменты обсуждения поверх документации, уровня того же Confluence
Инкрементальная сборка - это уже не "нажал кнопку и увидел"
Ну и нужны инструменты обсуждения поверх документации, уровня того же Confluence
VS
Есть много диаграмм, которые нарисовать в генерируемом виде и без использования элементов графического дизайна — сложно!
Это правда, такие диаграммки приходится складывать в папку
Мы такое либо исходником из draw.io, либо картинкой.
Если допилим препроцессор, будем исходник точно держать в папке.
https://marketplace.visualstudio.com/items?itemName=hediet.vscode-drawio
Мы такое либо исходником из draw.io, либо картинкой.
Если допилим препроцессор, будем исходник точно держать в папке.
https://marketplace.visualstudio.com/items?itemName=hediet.vscode-drawio
VA
Хм, там wysiwyg или что-то еще? Людям, увы, нужно именно оно и не хуже ворда (
Инкрементальная сборка - это уже не "нажал кнопку и увидел"
Ну и нужны инструменты обсуждения поверх документации, уровня того же Confluence
Инкрементальная сборка - это уже не "нажал кнопку и увидел"
Ну и нужны инструменты обсуждения поверх документации, уровня того же Confluence
Кому нужен wysiwyg?
KV
Это правда, такие диаграммки приходится складывать в папку
Мы такое либо исходником из draw.io, либо картинкой.
Если допилим препроцессор, будем исходник точно держать в папке.
https://marketplace.visualstudio.com/items?itemName=hediet.vscode-drawio
Мы такое либо исходником из draw.io, либо картинкой.
Если допилим препроцессор, будем исходник точно держать в папке.
https://marketplace.visualstudio.com/items?itemName=hediet.vscode-drawio
О, а допилите :)
VA
Мне кажется те, кому нужен такой подход уже не пишут доки)
VA
В текстовом подходе всё удобнее, кроме того, что надо привыкнуть.