Size: a a a

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

2020 December 05

VS

Vadim Smelyanskiy in DocOps-сообщество
Под "ручками" я имею в виду, что не целиком скриптами из исходника в XSLX, а приходится конвертировать самому и складывать CSV в папку
источник

VA

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

VS

Vadim Smelyanskiy in DocOps-сообщество
Хотя надо сказать, что на этом этапе я ещё чищу от всякой мусорной "вёрстки", которую некоторые люди накидывают в Excel'е, так что целиком этот этап, наверное, и не нужно пытаться автоматизировать
источник

PD

Phil Delgyado in DocOps-сообщество
Viktor Alexandrov
Вопрос необходимости и удобства.
При чем тут шаблон, просто в страницу вставить и все.
И это есть в конфе. И много еще чего.
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Phil Delgyado
При чем тут шаблон, просто в страницу вставить и все.
И это есть в конфе. И много еще чего.
"Просто вставить" можно и iframe с Google Sheets, но зачем?
источник

PD

Phil Delgyado in DocOps-сообщество
Viktor Alexandrov
Конфлюенс даёт инструменты анализа ссылок на документы и хоть какую-то семантику в режиме wysiwyg?)
Ну, вообще там всякое можно прикрутить плагинами. Их тысячи, я их все не знаю.
Это полноценная платформа - потому и сложно понять, а на что уходить.
И, главное, это не про сценарий "подготовки документации", это другой (другие) сценарии работы.
Документацию вообще надо выводить из Confluence как раз.
источник

VA

Viktor Alexandrov in DocOps-сообщество
Phil Delgyado
При чем тут шаблон, просто в страницу вставить и все.
И это есть в конфе. И много еще чего.
руки бы поотрывать
источник

NV

Nick Volynkin in DocOps-сообщество
Vadim Smelyanskiy
Только что причесал CLI самого IUI, чтобы не нужно было чекаутить проект, ща это в питон упаковываю
Огонь
источник

NV

Nick Volynkin in DocOps-сообщество
Phil Delgyado
Не доки, а knowledge sharing database. Который пишут все.
Где информация от "где поближе лучше перекусить" и до "схемы офиса", от "архитектура системы 3 года назад" и до "памятка новому сотруднику".
Практически все.
И каждый час, потраченный на обучение - это выкинутый час, увы.
Нужна хорошая навигация, нужно максимально привычный вид и так далее. Иначе оно не взлетит.
Вот я соглашусь с Филом: у wiki-движков есть своя ниша, в которой они удобнее, чем связка docs-as-code. Если пытаться всех заставить писать в Md и коммитить в гит, у них работа встанет.
источник

NV

Nick Volynkin in DocOps-сообщество
Hartmann
Хм. Интересно, одному мне при прочтении «гильдии» немедленно вспомнился старый, добрый WoW?
Мне раньше вспоминался, но я уже привык к новому значению
источник

СФ

Семён Факторович... in DocOps-сообщество
Nick Volynkin
Мне раньше вспоминался, но я уже привык к новому значению
Купец (ну или техписатель) третьей гильдии
источник

ML

Maksim Lapshin in DocOps-сообщество
Кстати, поделюсь. Насильно мы все продуктовые договора (те серийные и повторяемые) засунули в биллинг в виде маркдауна, из которого пандоком генерируется все что нужно для желающих.

Стало сильно лучше, чем свалка вордовых файлов черти где, потому что не «фрики программисты» попросту не представляют как наводить порядок в файлах на компьютерах.
источник

AB

Arina Ballerina in DocOps-сообщество
Интересно, что можно рассматривать базу знаний в условном конфлюенсе и сборку доки с гитом и SSG как какие-то взаимоисключающие вещи. У меня было так. Одна большая база знаний в конфлюенсе. Туда пишут всё, все и для всех. У меня там был уютный тупичок, где я писала техническую документацию. Оттуда с помощью pandoc+MkDocs и скриптов на питоне генерировалась дока на сайт (гит хотели прикрутить, но не успели). И мне нравилось. Во-первых у меня был какой-никакой единый источник (и единый поиск по конфлюенсу). Во-вторых, если надо было согласовать что-то в документе с огромной и такой разной командой (а мы все были считай на удалёнке), это не было стрессом ни для меня, ни для членов команды. Ну и комменты, которые собираюстся в диалог и хранятся в истории.
источник

PD

Phil Delgyado in DocOps-сообщество
Arina Ballerina
Интересно, что можно рассматривать базу знаний в условном конфлюенсе и сборку доки с гитом и SSG как какие-то взаимоисключающие вещи. У меня было так. Одна большая база знаний в конфлюенсе. Туда пишут всё, все и для всех. У меня там был уютный тупичок, где я писала техническую документацию. Оттуда с помощью pandoc+MkDocs и скриптов на питоне генерировалась дока на сайт (гит хотели прикрутить, но не успели). И мне нравилось. Во-первых у меня был какой-никакой единый источник (и единый поиск по конфлюенсу). Во-вторых, если надо было согласовать что-то в документе с огромной и такой разной командой (а мы все были считай на удалёнке), это не было стрессом ни для меня, ни для членов команды. Ну и комменты, которые собираюстся в диалог и хранятся в истории.
Угу, у нас примерно также. Потому и есть вопрос - как и куда уходить с конфлюенса
источник
2020 December 06

M

Maria in DocOps-сообщество
Здравствуйте, может есть у кого типовые, если не жалко..
1.регламент резервного копирования облачных данных
2.регламент техобслуживания и обработки обращений
3.регламент восстановления работоспособности системы в случае сбоя, все для облачных
источник

VA

Viktor Alexandrov in DocOps-сообщество
Мне кажется типовых быть не может.
источник

VA

Viktor Alexandrov in DocOps-сообщество
Я думаю вам стоит просто поговорить с вашими админами/девопсами/sre или как у вас принято их назвать
источник

M

Maria in DocOps-сообщество
Viktor Alexandrov
Мне кажется типовых быть не может.
Жаль) ладно, спасибо!
источник

PD

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

VA

Viktor Alexandrov in DocOps-сообщество
Возможно речь шла про оформление документа и набор тезисов, которые надо раскрыть. Но лучше так не делать, не лить воды в доки, покуда не требуют «оформлений по гостам».
источник