Size: a a a

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

2019 March 05

NV

Nick Volynkin in DocOps-сообщество
Пока что у меня есть одна идея: ставить условные блоки и собирать N версий доки под каждую роль. На sphinx такое можно сделать.
источник

s

sidigi in DocOps-сообщество
можно допилить парсер
источник

NV

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

A

Antonio in DocOps-сообщество
Nick Volynkin
Пока что у меня есть одна идея: ставить условные блоки и собирать N версий доки под каждую роль. На sphinx такое можно сделать.
asciidoc тоже такое рулит нормально
источник

NV

Nick Volynkin in DocOps-сообщество
.. ifconfig:: user in ('morpheus', 'neo', 'trinity')

  There is no spoon
источник

NV

Nick Volynkin in DocOps-сообщество
И это разделение прав же ещё надо распространить на поиск. Иначе люди будут видеть в поисковой выдаче куски контента, который для них не предназначен.

Вот если собирать N версий доки и для каждой поиск, то эта проблема  в принципе должна решиться.
источник

s

sidigi in DocOps-сообщество
для каждой роли своя дока?
источник

s

sidigi in DocOps-сообщество
кстати почему бы и нет)
источник

NV

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

s

sidigi in DocOps-сообщество
есть у тебя 5- 10 ролей, генерируешь 10 документаций, и в зависимости от роли просто показываешь необходимую версию)
источник

A

Antonio in DocOps-сообщество
у меня так организована дока по админке продукта
источник

NV

Nick Volynkin in DocOps-сообщество
Antonio
у меня так организована дока по админке продукта
Приходи рассказать об этом на митапе!
источник

A

Antonio in DocOps-сообщество
запилена, как ни странно, в Confluence 😁
источник

AR

Anna Ryutina in DocOps-сообщество
Antonio
у меня так организована дока по админке продукта
это как?
источник

A

Antonio in DocOps-сообщество
Nick Volynkin
Приходи рассказать об этом на митапе!
я б с удовольствием, только далековато идти :(
источник

NV

Nick Volynkin in DocOps-сообщество
Рассказывали мне историю про доставку документации в одной сильно зарегулированной отрасли. Там у клиента во внутренней изолированной сети есть Windows-сервер, на нём в сеть расшарен диск, на нём вложенные папки, в которых разложены доки в .chm. Пользователям раздают права доступа к папкам, они могут читать предназначенные для них доки.
источник

NV

Nick Volynkin in DocOps-сообщество
Antonio
я б с удовольствием, только далековато идти :(
Откуда? А то у нас митапы мобильные, почти кочевые.
источник

L

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

A

Antonio in DocOps-сообщество
Anna Ryutina
это как?
Single publishing source, 2 выходные документации, одна для админов, вторая для кастомер саппорта. Контент для каждой дергается порциями в зависимости от того, что доступно для роли
источник

AR

Anna Ryutina in DocOps-сообщество
а, это понятно, я думала еще есть методы, не делая кучу доков
источник