Size: a a a

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

2019 July 25

LZ

Lev Zabudko in DocOps-сообщество
спасибо! посмотрим
источник

LZ

Lev Zabudko in DocOps-сообщество
Сходу прямо похоже на то, что нужно
источник

НН

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

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

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

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

НН

Нац Нац in DocOps-сообщество
боле формальный, чем в сообщении, имеется в виду
источник

НН

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

LZ

Lev Zabudko in DocOps-сообщество
Вот такую презентацию собрали на reveal.js
источник

LZ

Lev Zabudko in DocOps-сообщество
источник

LZ

Lev Zabudko in DocOps-сообщество
Там требования есть в высокоуровневом формате. Более низкоуровневые как раз нужно обсуждать.
источник

LZ

Lev Zabudko in DocOps-сообщество
У нас правда все а markdown, но наверное Antora можно подружить с нашими форматами
источник

НН

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

A

Antonio in DocOps-сообщество
Lev Zabudko
У нас правда все а markdown, но наверное Antora можно подружить с нашими форматами
Антора дружит только с аскидоктором
источник

NV

Nick Volynkin in DocOps-сообщество
Но pandoc подружит кого угодно с кем угодно
источник

NV

Nick Volynkin in DocOps-сообщество
Семён Факторович
Ты хотел сказать, pandoc и неопределенное количество доработок напильником:)
Точнее, pandoc и напильник
источник

A

Antonio in DocOps-сообщество
Nick Volynkin
Но pandoc подружит кого угодно с кем угодно
для миграции да, но, как по мне, использовать его для постоянной конвертации не комильфо
источник

LZ

Lev Zabudko in DocOps-сообщество
Нац Нац
Посибо, гляжу. У нас этим занялись ПМ-ы (у нас плоская структура, дев, пм, сео), я вот напрашиваюсь к ним на обсуждение всех этих вещей и домашка каждому - собрать список рекваерментов, сверить их и выбрать одну тулзу-победителя которая покроет все рекваерменты
если будете делать такое и выберите - говорите :) Мы бы оч признательны были
источник

IA

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

НН

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

L

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

НН

Нац Нац in DocOps-сообщество
Lana
Пошукай onebar он поддерживает маркдаун и автосоздание страничек с решениями из слэка если у вас слэк в ходу
Шарю, тут с него кто-то даже тусовался, но нужно бОльшее, ассайнить таски, приоритеты выставлять, роадмапы
источник

L

Lana in DocOps-сообщество
А в Notion все хорошо, пока тебе не надо разграничивать права на редактирование
источник