Size: a a a

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

2019 July 25

НН

Нац Нац in DocOps-сообщество
А что с ними не так? Там вроде как можно выдать права на команду
источник

L

Lana in DocOps-сообщество
Я его как домашнюю kb использую
источник

L

Lana in DocOps-сообщество
Нац Нац
А что с ними не так? Там вроде как можно выдать права на команду
Ну вот ролей нет, но если у вас нет такого требования - идеально
источник

НН

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

НН

Нац Нац in DocOps-сообщество
Можно сделать группу HR или там QA и выдавать так
источник

НН

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

L

Lana in DocOps-сообщество
Нац Нац
Можно сделать группу HR или там QA и выдавать так
А платить тогда за 4 команды отдельно или пер юзеров?
источник

НН

Нац Нац in DocOps-сообщество
Платить, как и раньше, Per user, как я понимаю. т.к группы делаются из уже существубщих юзеров
источник

L

Lana in DocOps-сообщество
Нац Нац
Платить, как и раньше, Per user, как я понимаю. т.к группы делаются из уже существубщих юзеров
Это прям класс
источник

НН

Нац Нац in DocOps-сообщество
я уже пару раз подталкивал всех к мысли о Notion, всем зашло, но деняг надо. Может в этот раз свезёт, совсем не хо конфлюенс
источник

L

Lana in DocOps-сообщество
Я пропустила  появление group access
источник

LZ

Lev Zabudko in DocOps-сообщество
Ivan Abashkin
У вас там xwiki на последнем слайде. Мы так её и не победили, замороченная она.
Посмотрите на https://www.bookstackapp.com/ она намного дружелюбнее и маркдаун поддерживает.
Спасибо!
источник

НН

Нац Нац in DocOps-сообщество
У них недавно запустился красивый хелпцентр сделанный на своем же сервисе, выглядит оч гуд
источник

IA

Ivan Abashkin in DocOps-сообщество
Нац Нац
@lev_zabudko у нас, к слову, пока букстак, он хороший, но порываются что-то солиднее юзать, а-ля конфлюенс, но я хочу топить за Notion, если таки решат платить за что-то типа такого
ноушн хорош, но только облачный. у нас параноя, облако не разрешают.

Поэтому для внутренней kb выбирать особо и неизчего.
источник

НН

Нац Нац in DocOps-сообщество
Ivan Abashkin
ноушн хорош, но только облачный. у нас параноя, облако не разрешают.

Поэтому для внутренней kb выбирать особо и неизчего.
Да, я сам ультрадолго мучался с выбором kb, всё или супер дорого или монструозно или очень сырое, остановились на букстаке пока (он оч ок сапортится, опенсорс, селфхостед, есть реюзабл контент, развивается, есть роадмеп вроде даже), посмотрим что будет осенью. Из всего импонирует только ноушн
источник

IA

Ivan Abashkin in DocOps-сообщество
Нац Нац
Да, я сам ультрадолго мучался с выбором kb, всё или супер дорого или монструозно или очень сырое, остановились на букстаке пока (он оч ок сапортится, опенсорс, селфхостед, есть реюзабл контент, развивается, есть роадмеп вроде даже), посмотрим что будет осенью. Из всего импонирует только ноушн
вот, подписываюсь.

Я конечно пока не шарю, может сейчас бред скажу. Но вот думаю, может антора сможет помочь в наведении порядка? Сделать всё  на ней: и внутреннюю и внешнюю базу знаний.
источник

K

Konstantin in DocOps-сообщество
Lev Zabudko
Всем привет!

У нас есть интересная внутренняя задача, связанная с системой распространения знаний. Может быть у кого-то есть подобный опыт? Общался с @Nick_Volynkin он навел на Атлас у Авито, пошли узнавать по знакомым что там за штука и как используется, но это их внутренний инсструмент, который скорее всего никак не достать.

В общем, наша боль: есть потребность в инструменте, который бы автоматизированно собирал информацию из git-репозиториев в какое-то место (например wiki), которым было бы удобно пользоваться всем - техписам, сервисной службе, тестироващикам, девопс и т.д. Мы собрали требования и задача в общем звучит как некая матричная структура, где по горизонтали описаны все микросервисы (как раз та часть, которая хранится в git-e) с changelog, версиями, версиями api по гайдам, которые мы сами сделали, readme. По вертикали были бы описаны бизнес-функции, где и как эти сервисы участвуют - эта часть уже не автогенерируемая, скорее всего. Бонус ко всему этому - структура взаимосвязей всех сервисов - тут есть понятные опенсорсные инструменты, которыми можно сделать такую карту, взяв связи из конфига или package.json (для nodeJS приложений). Ну и горизонталь и вертикаль это абстракция, а не конкретное представление в виде таблицы :)

С чем нужно помочь:
Есть ли у вас опыт построения подобных систем? Есть ли какие-то инструменты, подходящие под задачу?
Сходу хочется написать несколько микросервисов, которые мы встроим в пайплайн гитлаба, просто подавая информацию в нужном виде, а они сами будут все переваривать и перепубликовать. Но выглядит как костыль, который возможно кто-то писал и как-то до нас прошел. Писать в целом не долго такую штуку, но ее же потом поддерживать и развивать нужно.
Мы в итоге решили запилить похожу тулзу сами: https://foliant-docs.github.io/docs/
источник

LZ

Lev Zabudko in DocOps-сообщество
Konstantin
Мы в итоге решили запилить похожу тулзу сами: https://foliant-docs.github.io/docs/
Спасибо большое! Будем смотреть! Антора все же не совсем то, так как там аскидок
источник

K

Konstantin in DocOps-сообщество
Прорекламирую заодно наш уютный чатик про Foliant: https://t.me/foliantdocs
источник

LZ

Lev Zabudko in DocOps-сообщество
Ivan Abashkin
У вас там xwiki на последнем слайде. Мы так её и не победили, замороченная она.
Посмотрите на https://www.bookstackapp.com/ она намного дружелюбнее и маркдаун поддерживает.
Попросил админов поставить. На днях сравним, может и переедем. Xwiki никому не нравится, но за неимением лучшего - ведем ее
источник