Size: a a a

DocOps-сообщество

2020 December 05

VA

Viktor Alexandrov in DocOps-сообщество
Ну, я щас про айти исключительно, конечно же
источник

PD

Phil Delgyado in DocOps-сообщество
Viktor Alexandrov
Кому нужен wysiwyg?
Менеджерам, аналитикам, HRам, бухам и т.п.
Всем, кроме фриков-программистов и присоединившихся техрайтеров
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Phil Delgyado
Хм, там wysiwyg или что-то еще? Людям, увы, нужно именно оно и не хуже ворда (
Инкрементальная сборка - это уже не "нажал кнопку и увидел"
Ну и нужны инструменты обсуждения поверх документации, уровня того же Confluence
У нас почему-то нет, только превью маркдауна. Но есть issues на гитлабе про ToastUI, вроде как-то его можно прикрутить.

А так памятку по Markdown'у получалось и маркетологам давать, которые вот вообще не хотели в наши процессы вникать, так что хз насчёт "нужен"
источник

VA

Viktor Alexandrov in DocOps-сообщество
Phil Delgyado
Менеджерам, аналитикам, HRам, бухам и т.п.
Всем, кроме фриков-программистов и присоединившихся техрайтеров
Зачем им всем писать доки? Есть ИС для их работы :)

А тем кому надо — напишут. И менеджеры, и аналитики, и даже HRы
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Konstantin Valeev
О, а допилите :)
Ща, разберусь как их собирать нормально, всё будет)
источник

PD

Phil Delgyado in DocOps-сообщество
Viktor Alexandrov
Мне кажется те, кому нужен такой подход уже не пишут доки)
Не доки, а knowledge sharing database. Который пишут все.
Где информация от "где поближе лучше перекусить" и до "схемы офиса", от "архитектура системы 3 года назад" и до "памятка новому сотруднику".
Практически все.
И каждый час, потраченный на обучение - это выкинутый час, увы.
Нужна хорошая навигация, нужно максимально привычный вид и так далее. Иначе оно не взлетит.
источник

PD

Phil Delgyado in DocOps-сообщество
Viktor Alexandrov
Зачем им всем писать доки? Есть ИС для их работы :)

А тем кому надо — напишут. И менеджеры, и аналитики, и даже HRы
Не, им надо только если просто. А вот всем - надо, что бы они свои знания складывали.
источник

PD

Phil Delgyado in DocOps-сообщество
И да, экспорт из ворда и экселя тоже необходим.
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Viktor Alexandrov
Зачем им всем писать доки? Есть ИС для их работы :)

А тем кому надо — напишут. И менеджеры, и аналитики, и даже HRы
Иногда проще получить черновик из первых рук
источник

PD

Phil Delgyado in DocOps-сообщество
Нет, так как это про "увидел неточность - исправил ее", "появились заметки по встречи - выложил их".
источник

VA

Viktor Alexandrov in DocOps-сообщество
Phil Delgyado
Не доки, а knowledge sharing database. Который пишут все.
Где информация от "где поближе лучше перекусить" и до "схемы офиса", от "архитектура системы 3 года назад" и до "памятка новому сотруднику".
Практически все.
И каждый час, потраченный на обучение - это выкинутый час, увы.
Нужна хорошая навигация, нужно максимально привычный вид и так далее. Иначе оно не взлетит.
Это knowledge sharing database, а помойка обычно)))
источник

VA

Viktor Alexandrov in DocOps-сообщество
Зайдите в любую корпоративную конфлю
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Phil Delgyado
И да, экспорт из ворда и экселя тоже необходим.
Импорт/экспорт Word даёт Pandoc + Foliant
источник

VA

Viktor Alexandrov in DocOps-сообщество
И попробуйте найти нужную информацию
источник

PD

Phil Delgyado in DocOps-сообщество
Viktor Alexandrov
Это knowledge sharing database, а помойка обычно)))
Ну, какая есть, но даже confluence дает инструменты ее удержания в более-менее приличном виде.
При несложных усилиях (и да, я видел много корпоративных вики и я находил там информацию без особого труда)
источник

PD

Phil Delgyado in DocOps-сообщество
И лучше, когда информация есть, чем ее нет
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Excel хитрее, я ручками в CSV перегоняю
https://foliant-docs.github.io/docs/preprocessors/csvtables/

Если сильно захотеть, можно сделать и для xlsx->csv препроцессор
источник

VA

Viktor Alexandrov in DocOps-сообщество
Phil Delgyado
И лучше, когда информация есть, чем ее нет
Протестую. Наличие обилия некорректной информации хуже чем её отсутствие и решение вопроса путём «найти нужного человека» или «заглянуть в бухгалтерию»
источник

VA

Viktor Alexandrov in DocOps-сообщество
Vadim Smelyanskiy
Excel хитрее, я ручками в CSV перегоняю
https://foliant-docs.github.io/docs/preprocessors/csvtables/

Если сильно захотеть, можно сделать и для xlsx->csv препроцессор
Да excel можно парсить, если по шаблону сделан, без проблем. На любом языке есть либы
источник

VA

Viktor Alexandrov in DocOps-сообщество
Вопрос необходимости и удобства.
источник