Именно)

У нас интересное разделение в компании) Конфля звучит как-то по-девчачьи) В итоге девушки называют базу знаний конфля, а мужчины - конфа)

Вот что мне на это вчера друг котлинист сказал: "НЕЛЬЗЯ КОНФОЙ НАЗЫВАТЬ, ЭТО ДРУГОЕ ЖЕ СОВСЕМ НУ!". Я, конечно же, отметила, что в нашей компании, где я работала раньше, и о которой шла речь, путаницы быть не могло - конфлюэнсом пользовался, в основном, операционный отдел, который никогда на конференции не отправляли. И смешно, и грустно

Реально грустно. Обделённый отдел. А чем он там занимался, этот операционный отдел?

Поддержка, комплаенс. Маленькие био-винтики, в общем. Из-за чего и люди уходят пачками.

Притом та поддержка делала лучший сервис среди конкурентов - ради этого сервиса многие клиенты более крупные комиссии платили и т.д

Это был финансовый сектор?

Да

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

Коллеги, привет!

А поделитесь, пожалуйста, опытом, как в ваших компаниях проходит согласование новых терминов и именования новых сущностей? Интересует:

- кто и на каком этапе разработки выдвигает варианты именования;
- кто входит в группу согласующих;
- на ком обкатываете на предмет понятности/непонятности;
- боль переименования введённых названий/терминов.

Помимо глоссария, ещё какой-нибудь словарь внутренних терминов ведёте? Если да, по какому принципу разделяете: это в глоссарий, а это в наш словарь-справочник?

Может быть, был какой-нибудь доклад на эту тему на одной из конференций? Буду благодарна за ссылку.

О, коллеги, у меня тоже есть интересный вопрос на обсудить) Расскажите, как вы подтверждаете актуальность документации? Сейчас это обычно определяется по косвенным признакам. Условно, если редактировалось вчера, то, скорее всего, всё актуально. А если год назад, то, скорее всего, не актуально. Но это такой тонкий лёд, что вообще. Запросто может вчерашний документ быть не актуальным, сегодня вышло что-то новое, условно. А год назад другой документ как сделали, так ничего и не менялось, актуальный он. Интересен ваш опыт, коллеги, в примерно этом направлении)

Есть доклад Татьяны Грачёвой с Третьего Гипербатона https://events.yandex.ru/lib/talks/2845/ В числе прочего она рассказывает о внутреннем словаре.

Если это софт. То я всегда проставляю метки для какой версии актуально.

Ну да, простой и действенный как топор, метод)

В международном сообществе Write The Docs в Slack есть тема "doctools", где участники делятся различными ссылкам по инструментарию.

Сделал небольшой дайджест:

https://stepshot.net/ - Создаие динамической документации

http://www.picklesdoc.com/ - Делает из Markdown удобоваримый вид

https://pdfshift.io/#features - HTML в PDF

https://dev.to/kefranabg/generate-beautiful-readme-in-10-seconds-38i2 - Попытка создать ReadMe-генератор

https://easydita.com/ - Онлайн редактор DITA

https://www.wappalyzer.com/ - Узнать какие технологии использует сайт

https://stripe.com/docs/api - пример документации

https://www.twilio.com/docs/ -пример документации

ух ты как интересно. Спасибо!

>Делает из Markdown удобоваримый вид

Хорошее описание, все понятно что тулза делает

Stripe это вроде бы сервис для онлайн-платежей, а Twilio - платформа для коммуникаций с клиентами. Но их документация действительно хороша, сегодня на митапе участники приводили оба этих сервиса в пример.

Ага вот и в Slack там активно за пример этой документации топят