Size: a a a

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

2021 September 30

IC

Ivan Cheban in DocOps-сообщество
источник

IC

Ivan Cheban in DocOps-сообщество
Это на основе сайта с документацией Тома Джонсона я делал. Он на джекиле
источник

IC

Ivan Cheban in DocOps-сообщество
tomjoht/documentation-theme-jekyll: A Jekyll-based theme designed for documentation and help systems. See the link for detailed instructions on setting up and configuring everything.
https://github.com/tomjoht/documentation-theme-jekyll
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
Техписатели нужны, техписатели важны. Если серьезно, тестирование покрывает больше кейсов
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
Тестирование оно не только про банальные проверки (хотя, например, некоторые штуки позволяют делать генеративные тесты по спекам, типа clojure.spec), но и про человеческий фактор, плюс тестировщик может дать отзыв по юзабилити и не только. А писать нормальные докстринги не всегда есть время, особенно если дедлайны поджимают. Пишу как разраб)
источник

MM

Mikhail Mironov in DocOps-сообщество
Спасибо)
источник

P

Pavel in DocOps-сообщество
Так как описать требования к такому тестированию? Как определить эту "актуальность"? для одного оно кажется ещё актуальным, а другому уже нет и оба могут доказывать, что они правы. Для меня просто это какой-то размытый термин, который я не представляю как формализировать.
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
А ты его и не формализуешь полностью
источник

P

Pavel in DocOps-сообщество
Я не предлагал их отменять. А тесты надо поддерживать, как и документацию.
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
Да, но ручное тестирование никто не отменял
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
А дамп головы тестировщика на гитхаб не зальешь
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
А так-то линтеры в CI,  в том числе на покрытие - штука оч полезная
источник

P

Pavel in DocOps-сообщество
Кто-то же должен эти тест-кейсы для человека прописывать и поддерживать. Как и документацию, которую они должны были покрыть.
источник

P

Pavel in DocOps-сообщество
вроде про линтеры речи не шло
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
Не все кейсы берутся из требований/спек итп
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
Пришел тестировщик на работу с похмелья и ткнул не туда, опа - багуля, опа - новый кейс
источник
2021 October 01

D

Denis in DocOps-сообщество
Коллеги, подскажите, можно ли при помощи каких-то SSG организовать разделение доступа для разных клиентов?
источник

NV

Nick Volynkin in DocOps-сообщество
Через сами SSG наверняка нет, потому что в статическом наборе HTML+CSS+JS нет ничего про доступ. Но можно через вебсервер, который отдаёт статику.
источник

J

Jonny Cuba in DocOps-сообщество
Коллеги, подсветку (literalinclude::) кода pebble-шаблонов в sphinx+rst как то можно реализовать?
источник

D

Denis in DocOps-сообщество
Понятно, спасибо!
источник