Size: a a a

Архитектура ИТ-решений

2020 February 24

SV

Sergey V in Архитектура ИТ-решений
Посоветуйте, пожалуйста, книгу на mybook или litres (последнее — вряд ли) про определения разных «архитекторов», где заканчивается один, начинается другой, и что нужно знать на этих позициях.
источник

AK

Alexander Kudrin in Архитектура ИТ-решений
Коллеги кто-то может подсказать как организовать структуру базы знаний?
Начали писать статьи, в основном, по процессам, но часть весьма технического толка, набралась уже досаточная масса, чтобы в этом запутаться. Есть какие-то best practice по ведению базы знаний? Какую струкутру вы задаете?
источник

PD

Phil Delgyado in Архитектура ИТ-решений
Я стараюсь идти от читателя. Типа 'раздел для менеджера, раздел для онбординга, раздел для фронтенда' и т.п.
источник

PD

Phil Delgyado in Архитектура ИТ-решений
А внутри - или от проблемы (про разные how to) или по последовательности чтения (для обзоров архитектуры и т.п.).
источник

PD

Phil Delgyado in Архитектура ИТ-решений
Но смотря сколько у вас материалов. 100 страниц, 1000 или 100000 - требуют разных решений
источник

R

Rtem in Архитектура ИТ-решений
Phil Delgyado
Я стараюсь идти от читателя. Типа 'раздел для менеджера, раздел для онбординга, раздел для фронтенда' и т.п.
А эти разделы ведут разные люди?
источник

PD

Phil Delgyado in Архитектура ИТ-решений
Иногда да, иногда нет.
источник

IF

Ivan Fedorov in Архитектура ИТ-решений
Мы обычно пишем самые мелкие кирпичики. Как сделать то-то. А дальше уже любые группировки по процессам, по ролям, по системам и т.п.
источник

PD

Phil Delgyado in Архитектура ИТ-решений
Rtem
А эти разделы ведут разные люди?
Раздел с требованиями в основном ведут бизнес-аналитики, сейлзы, тимлиды.
А раздел для ops - сами ops и разработчики.
источник

PD

Phil Delgyado in Архитектура ИТ-решений
Важно, что бы был один человек, ответственный за структуру вообще (ну, один на 1000 страниц примерно), для отслеживания актуальности структуры, убирания дубликатов и т.п.
источник

PD

Phil Delgyado in Архитектура ИТ-решений
Ivan Fedorov
Мы обычно пишем самые мелкие кирпичики. Как сделать то-то. А дальше уже любые группировки по процессам, по ролям, по системам и т.п.
Угу. Обзорные статьи с ссылками, паралельные иерархии, вставки контента - смотря что система документирования позволяет.
источник

R

Rtem in Архитектура ИТ-решений
Phil Delgyado
Важно, что бы был один человек, ответственный за структуру вообще (ну, один на 1000 страниц примерно), для отслеживания актуальности структуры, убирания дубликатов и т.п.
А какой инструмент используете для ведения такой базы знаний? Confluence или что-то получше?
источник

PD

Phil Delgyado in Архитектура ИТ-решений
Confluence, это фактически стандарт.
Говорят, что xwiki уже ничего, но давно не смотрел.
источник

R

Rtem in Архитектура ИТ-решений
Phil Delgyado
Confluence, это фактически стандарт.
Говорят, что xwiki уже ничего, но давно не смотрел.
А что думаете о ведении подобных баз в формате markdown в гите?
источник

PD

Phil Delgyado in Архитектура ИТ-решений
1. А как этим будут пользоваться не программисты? Или нет такой задачи?
2. В стандартном маркдауне очень мало возможностей. А если добавлять расширения - то это будет уже привязка к чему-то конкретному
3. Просто в гите или в гитлабе или на гитхабе? Сильно зависит от дополнительных возможностей типа комментариев к тексту.
источник

R

Rtem in Архитектура ИТ-решений
С “непрограммистами” проблема есть. Есть и варианты решения, но они все так себе на вкус. Имелась в виду конечно же какая-то площадка типа гитхаба или гитлаба.

А каких возможностей не хватает в стандартном маркдауне по сравнени с конфой?
источник

Ms

Mutko says in Архитектура ИТ-решений
Попробуйте там поредактировать таблицы
источник

R

Rtem in Архитектура ИТ-решений
Mutko says
Попробуйте там поредактировать таблицы
Валидное замечание =) Для меня это всегда боль =)
источник

R

Rtem in Архитектура ИТ-решений
Так или иначе спасает Notion, но это уже скорее из области решений проблем, которые вероятно можно не создавать изначально.
источник

PD

Phil Delgyado in Архитектура ИТ-решений
Rtem
С “непрограммистами” проблема есть. Есть и варианты решения, но они все так себе на вкус. Имелась в виду конечно же какая-то площадка типа гитхаба или гитлаба.

А каких возможностей не хватает в стандартном маркдауне по сравнени с конфой?
Ну, в маркдауне почти ничего нет. Нет диаграмм (а это нужно), нет include, нет toc, нет инлайновых комментариев, нет labels, нет всяких "список всех страниц по такому-то фильтру с описанием каждой из них".
источник