Size: a a a

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

2020 July 04

NV

Nick Volynkin in DocOps-сообщество
ага, в инструментах разработчика
источник

NV

Nick Volynkin in DocOps-сообщество
но там необязательно будет этот тег
источник

NV

Nick Volynkin in DocOps-сообщество
я считерил — открыл инспектор и поискал "docusaurus" :)
источник
2020 July 05

L

Lana in DocOps-сообщество
А можно совсем считерить и использовать wappalyser
источник

L

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

L

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

IC

Ivan Cheban in DocOps-сообщество
Спасибо! Странно только, что этот сервис не распознал Algolia, которая используется для поиска
источник
2020 July 06

J

Jonny Cuba in DocOps-сообщество
Друзья! Взаимно приглашаем в гости к техническим писателям @twriters
источник

ML

Maksim Lapshin in DocOps-сообщество
Мы добили у себя такой техпроцесс:

тесты на cypress проходят по написанным сценариям. Конфиги в документацию вставляются прям из этих тестов (т.е. они точно проверены).

В нужных местах сипресс делает скриншот и этот скриншот сохраняется на диск. Если разница с предыдущей версией скриншота большая, то в гитлабе делается merge request на изменение скриншотов.

посмотреть разницу можно прям в гитлабе, у него готовые инструменты для сравнения картинок неплохие.
источник

NV

Nick Volynkin in DocOps-сообщество
Maksim Lapshin
Мы добили у себя такой техпроцесс:

тесты на cypress проходят по написанным сценариям. Конфиги в документацию вставляются прям из этих тестов (т.е. они точно проверены).

В нужных местах сипресс делает скриншот и этот скриншот сохраняется на диск. Если разница с предыдущей версией скриншота большая, то в гитлабе делается merge request на изменение скриншотов.

посмотреть разницу можно прям в гитлабе, у него готовые инструменты для сравнения картинок неплохие.
Максим, это офигенно.
источник

DB

Dima Boger in DocOps-сообщество
Maksim Lapshin
Мы добили у себя такой техпроцесс:

тесты на cypress проходят по написанным сценариям. Конфиги в документацию вставляются прям из этих тестов (т.е. они точно проверены).

В нужных местах сипресс делает скриншот и этот скриншот сохраняется на диск. Если разница с предыдущей версией скриншота большая, то в гитлабе делается merge request на изменение скриншотов.

посмотреть разницу можно прям в гитлабе, у него готовые инструменты для сравнения картинок неплохие.
о, снепшот тестики ❤️
источник

ML

Maksim Lapshin in DocOps-сообщество
Dima Boger
о, снепшот тестики ❤️
ключевая штука здесь не в том, что мы тестируем идентичность гуя скриншотами, а в том, что после прогона тестов, если они зеленые, то остаются скриншоты. Эти скриншоты кладутся в документацию.

Т.е. корректность и актуальность данных в документации проверяется роботом
источник

DB

Dima Boger in DocOps-сообщество
Maksim Lapshin
ключевая штука здесь не в том, что мы тестируем идентичность гуя скриншотами, а в том, что после прогона тестов, если они зеленые, то остаются скриншоты. Эти скриншоты кладутся в документацию.

Т.е. корректность и актуальность данных в документации проверяется роботом
А какой алгоритм проверки, что скриншот поменялся сильно?
источник

ML

Maksim Lapshin in DocOps-сообщество
Dima Boger
А какой алгоритм проверки, что скриншот поменялся сильно?
уточню
источник

SR

Stas Rychkov in DocOps-сообщество
Maksim Lapshin
уточню
matchTemplate()?
источник

DB

Dima Boger in DocOps-сообщество
Maksim Lapshin
уточню
И сразу в догонку вопрос, который всегда вокруг снепшот-тестирования есть — а как процесс работает, когда меняется внешний вид какого-нибудь частоупотребимого компонента типа чекбокса. Просматриваете все скриншоты не прилетело ли ломающее документацию изменение или принимаете на веру
источник

ML

Maksim Lapshin in DocOps-сообщество
Dima Boger
И сразу в догонку вопрос, который всегда вокруг снепшот-тестирования есть — а как процесс работает, когда меняется внешний вид какого-нибудь частоупотребимого компонента типа чекбокса. Просматриваете все скриншоты не прилетело ли ломающее документацию изменение или принимаете на веру
пока просмотр
источник
2020 July 08

NK

ID:0 in DocOps-сообщество
​​Опрос про хостинг документации.

Мои знакомые делают инструмент для хостинга небольших сайтов, в том числе документации. Судя по рассказам, там будет автоматизирована куча важных штук, которые я бы не хотел делать вручную.

Мы вместе составили небольшой опросник про то, как хостятся документационные проекты. Пожалуйста, расскажите о своём опыте, там на 5-10 минут. С теми, кто оставит почту, обещают поделиться результатами опроса и демкой инструмента.
источник

СФ

Семён Факторович... in DocOps-сообщество
ID:0
​​Опрос про хостинг документации.

Мои знакомые делают инструмент для хостинга небольших сайтов, в том числе документации. Судя по рассказам, там будет автоматизирована куча важных штук, которые я бы не хотел делать вручную.

Мы вместе составили небольшой опросник про то, как хостятся документационные проекты. Пожалуйста, расскажите о своём опыте, там на 5-10 минут. С теми, кто оставит почту, обещают поделиться результатами опроса и демкой инструмента.
очень страшные вопросы!
источник

СФ

Семён Факторович... in DocOps-сообщество
(речь идет о хостинге документации же, я всё правильно понял?)
источник