Size: a a a

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

2019 July 05

L

Lana in DocOps-сообщество
Илья Улеско
А вы аргументы собираете только потому, что хотите остаться в рамках привычного стека? Или не факт, что вы/ваша команда будете настраивать и _поддерживать_ документацию?
Думаю, что во втором случае нужна именно экспертиза и сравнение продуктов с учетом потребностей и ресурсов (люди/деньги/время) заказчика.
Не совсем пока понятно, нас попросили за экспертизу, возможно помогать будем в первичной настройке (но это не точно), а потом поддерживать будет кто-то
источник

L

Lana in DocOps-сообщество
Аргументы не для меня, я скорее вынесла на всеобщее обсуждение саму дихотомию
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Lana
Вот, вот оно, заберу этот аргумент в копилку
Можно ещё дотащить этот аргумент до ответа на главное возражение руководства

Придумайте, как оценить/замерять время на решение типовых задач с помощью разных инструментов. Иногда так нужные данные прямо выпрыгивают на глаза.

Я так в разное время замерял на работе, как долго я в роли разраба и коллеги проходили типичные сценарии с JIRA и с YouTrack.

Оказалось, что даже спустя полгода после перехода на JIRA, трекать время стали в два раза дольше, статусы задач перестали быть актуальными и т.д.

Потому что неудобно)
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Дельта времени * ЗП сотрудников = возросший расход. Регулярный расход.

Разовые траты, это ещё ладно, но когда "кешфлоу протекает", бизнес сразу начинает шевелиться в поисках решения
источник

A

Antonio in DocOps-сообщество
Jaroslaw Martinow
Кому с инструментом работать - тому инструмент и выбирать. На выходе всё равно доки.
идельно. Тоже забрал себе в аргументы! :)
источник
2019 July 10

АК

Анатолий Клюса in DocOps-сообщество
Коллеги, подскажите, есть ли возможность в гитлабе подсунуть для рендеринга asciidoc свой css-стиль?
Если да, то где?
источник
2019 July 12

NV

Nick Volynkin in DocOps-сообщество
Случайно нагуглил и не понимаю, зачем в документации Symfony опубликованы ошибки сборки этой самой документации. https://symfony.com/doc/build_errors

Как вы думаете? Случайный артефакт сборки?
источник

NV

Nick Volynkin in DocOps-сообщество
Причём документация-то на Sphinx/reST )
источник

OI

Olga Ilchukova in DocOps-сообщество
И не написано, что с ними делать. Загадочная страница.
источник

L

Lana in DocOps-сообщество
Nick Volynkin
Случайно нагуглил и не понимаю, зачем в документации Symfony опубликованы ошибки сборки этой самой документации. https://symfony.com/doc/build_errors

Как вы думаете? Случайный артефакт сборки?
Забыли в игнор добавить может?
источник

NV

Nick Volynkin in DocOps-сообщество
Lana
Забыли в игнор добавить может?
Наверное )
источник

NV

Nick Volynkin in DocOps-сообщество
источник

OI

Olga Ilchukova in DocOps-сообщество
Хехе :)
источник

RZ

Roman Zh in DocOps-сообщество
источник

NK

ID:0 in DocOps-сообщество
Инструкция к Palantir Gotham.
В сеть утекла техническая документация к сервису для поиска данных о гражданах, который использует полиция и спецслужбы США. Сервис называется Palantir Gotham. Документация конкретно пользовательская, писали не для отчётности. В начале документа — «шпаргалки», четкие пошаговые инструкции со скриншотами. Потом более подробные инструкции, описания конкретных элементов интерфейса и сценариев.

Документация в PDF и plain text: https://www.documentcloud.org/documents/6190005-PALANTIR-Guide.html
Исходная статья: https://www.vice.com/en_us/article/9kx4z8/revealed-this-is-palantirs-top-secret-user-manual-for-cops
Про статью узнал из поста в @addmeto.

Приходите обсуждать в чат @docsascode. Тема этически сложная, давайте обойдем стороной холивары о политике и обсудим именно артефакт документации.
источник

NV

Nick Volynkin in DocOps-сообщество
Явным образом прошу вас не спорить здесь о политике. Для политики есть другие чаты.
источник

НН

Нац Нац in DocOps-сообщество
Круууута
источник

FM

Fox Mulder in DocOps-сообщество
Кстати неплохо сделана дока, мне нравится
источник

H

Hartmann in DocOps-сообщество
ID:
Инструкция к Palantir Gotham.
В сеть утекла техническая документация к сервису для поиска данных о гражданах, который использует полиция и спецслужбы США. Сервис называется Palantir Gotham. Документация конкретно пользовательская, писали не для отчётности. В начале документа — «шпаргалки», четкие пошаговые инструкции со скриншотами. Потом более подробные инструкции, описания конкретных элементов интерфейса и сценариев.

Документация в PDF и plain text: https://www.documentcloud.org/documents/6190005-PALANTIR-Guide.html
Исходная статья: https://www.vice.com/en_us/article/9kx4z8/revealed-this-is-palantirs-top-secret-user-manual-for-cops
Про статью узнал из поста в @addmeto.

Приходите обсуждать в чат @docsascode. Тема этически сложная, давайте обойдем стороной холивары о политике и обсудим именно артефакт документации.
Ну документация, ну мусорская. Дальше что.
источник

AP

Anna P in DocOps-сообщество
ID:
Инструкция к Palantir Gotham.
В сеть утекла техническая документация к сервису для поиска данных о гражданах, который использует полиция и спецслужбы США. Сервис называется Palantir Gotham. Документация конкретно пользовательская, писали не для отчётности. В начале документа — «шпаргалки», четкие пошаговые инструкции со скриншотами. Потом более подробные инструкции, описания конкретных элементов интерфейса и сценариев.

Документация в PDF и plain text: https://www.documentcloud.org/documents/6190005-PALANTIR-Guide.html
Исходная статья: https://www.vice.com/en_us/article/9kx4z8/revealed-this-is-palantirs-top-secret-user-manual-for-cops
Про статью узнал из поста в @addmeto.

Приходите обсуждать в чат @docsascode. Тема этически сложная, давайте обойдем стороной холивары о политике и обсудим именно артефакт документации.
Выглядит, конечно, откровенно плохо, сам интерфейс тоже из казённых нулевых.))
Но написано такими простыми фразами и все наглядно, соответственно (предполагаю) техническому уровню пользователей. Это круто.
источник