Size: a a a

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

2019 March 12

NP

Nikolaj Potashnikov in DocOps-сообщество
Antonio
Ага, пасиба. У них дока крутая с примерами, пока хватает.
Собственно, я вот тоже решил на работе перевести графику в plaintext, есть быстрый вопрос по sequence, может кто подскажет:
Есть запрос, который идет от А к Б через В (например клиент-браузер-сервер)
Есть ли возможность в sequence как-то это нарисовать грубо говоря одной линией (нижняя стрелка), не используя разбиение на 2 (верхние 2)?
https://www.plantuml.com/plantuml/img/SoWkIImgAStDuNBKjNEoKWXABInDBIvHCEHoqhLpHkOxfEQbWDHnEI1hmQO40000
Хм, возможно я неправильно понимаю, что нужно, но я бы воспользовался нотациями activate, deactivate
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
И.. если это нефункциональный посредник, нужен ли он в схеме?
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
Может, просто отметить вызов стереотипом?
источник

TZ

Timofey Zakrevskiy in DocOps-сообщество
Семён Факторович
у меня с ходу было ощущение, что это довольно костыльный путь, поэтому и хочется посмотреть, как это делают другие
Не уверен, что в тему, но сервант умеет своё апи документировать вот так:
https://haskell-servant.readthedocs.io/en/stable/tutorial/Docs.html

Дальше привинчивается мост в пандок (servant-pandoc)
источник

A

Antonio in DocOps-сообщество
Nikolaj Potashnikov
Хм, возможно я неправильно понимаю, что нужно, но я бы воспользовался нотациями activate, deactivate
я тоже об этом думал, надо почитать, подходит ли оно в нашем случае. Спасибо
это функциональный посредник, убрать его нельзя.
про стереотип, думаю, лишнее. У нас юзер дока и мало кто умеет правильно читать uml
источник

OI

Olga Ilchukova in DocOps-сообщество
Всем привет. Поделитесь, как вы тестируете документацию в rst? Возможно, видели доклады о тестировании документации.
источник

NV

Nick Volynkin in DocOps-сообщество
Olga Ilchukova
Всем привет. Поделитесь, как вы тестируете документацию в rst? Возможно, видели доклады о тестировании документации.
А что ты хочешь тестировать?
источник

НН

Нац Нац in DocOps-сообщество
Olga Ilchukova
Всем привет. Поделитесь, как вы тестируете документацию в rst? Возможно, видели доклады о тестировании документации.
vale?
источник

NV

Nick Volynkin in DocOps-сообщество
Это тебе наверняка понравится https://testthedocs.org/index.html
источник

A

Antonio in DocOps-сообщество
Olga Ilchukova
Всем привет. Поделитесь, как вы тестируете документацию в rst? Возможно, видели доклады о тестировании документации.
источник

A

Antonio in DocOps-сообщество
+1
источник

OI

Olga Ilchukova in DocOps-сообщество
Nick Volynkin
А что ты хочешь тестировать?
вот как раз хотела бы узнать, какие стороны документации тестируют
источник

НН

Нац Нац in DocOps-сообщество
Spelling, grammar, style and readability
источник

NV

Nick Volynkin in DocOps-сообщество
Ссылки не 404!
источник

A

Antonio in DocOps-сообщество
Olga Ilchukova
вот как раз хотела бы узнать, какие стороны документации тестируют
синтаксис, ошибки, стилистика, иногда читабельность
источник

NV

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

OI

Olga Ilchukova in DocOps-сообщество
Antonio
синтаксис, ошибки, стилистика, иногда читабельность
какие инструменты используете для тестирования?
источник

НН

Нац Нац in DocOps-сообщество
Olga Ilchukova
какие инструменты используете для тестирования?
Vale
источник

OI

Olga Ilchukova in DocOps-сообщество
а! ок.
источник

OI

Olga Ilchukova in DocOps-сообщество
Большое спасибо! :)
источник