Size: a a a

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

2019 April 09

NV

Nick Volynkin in DocOps-сообщество
отредактировал маленько )
источник

OI

Olga Ilchukova in DocOps-сообщество
:D надо послать им пулл-реквест
источник

AP

Anna P in DocOps-сообщество
Nick Volynkin
отредактировал маленько )
Ааа, ору, как говорится.
источник
2019 April 16

SK

Sergei Kutcher in DocOps-сообщество
Доброго! Как вы относитесь к изображениям в одкументации?
источник

SK

Sergei Kutcher in DocOps-сообщество
Что-то типа: нажмите сюда, туда, результат. Или лучше оформить как Сюда→Туда→Результат?
источник

NV

Nick Volynkin in DocOps-сообщество
Мы пишем последовательности и добавляем скриншоты, например вот так: https://docs.plesk.com/en-US/onyx/quick-start-guide/plesk-tutorial.74376/
источник

NV

Nick Volynkin in DocOps-сообщество
Эта документация рассчитана на новых пользователей, поэтому объясняем подробно
источник

NV

Nick Volynkin in DocOps-сообщество
Sergei Kutcher
Что-то типа: нажмите сюда, туда, результат. Или лучше оформить как Сюда→Туда→Результат?
Ответил )
источник

A

Anatoliy in DocOps-сообщество
Sergei Kutcher
Доброго! Как вы относитесь к изображениям в одкументации?
Все зависит от контекста, и как Ник сказал, аудитории. Идеально текст + сопровождающий скриншот. Рисунок нагляднее и проще, но изменения в него вносить сложнее.
источник

H

Hartmann in DocOps-сообщество
Anatoliy
Все зависит от контекста, и как Ник сказал, аудитории. Идеально текст + сопровождающий скриншот. Рисунок нагляднее и проще, но изменения в него вносить сложнее.
Анатолий, Вы и тут, и там успеваете. :)
источник

AR

Anna Ryutina in DocOps-сообщество
скриншоты это норм, я где-то видела даже видео. А вот просто картинки для "красоты" справки, сложно поддерживать (например когда обертка для веб-справки разная для разных компаний и требуется не только другой цвет картинки, но и стилистика)
источник

H

Hartmann in DocOps-сообщество
Anna Ryutina
скриншоты это норм, я где-то видела даже видео. А вот просто картинки для "красоты" справки, сложно поддерживать (например когда обертка для веб-справки разная для разных компаний и требуется не только другой цвет картинки, но и стилистика)
В таком случае, лучше скрины, чем видео. Мне неоднократно приходилось переделывать по 200-300 скринов к каждой документации из-за изменившейся цветовой схемы. Ничё, жив. А представьте перезаписывать видео с озвучкой.
источник

AR

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

H

Hartmann in DocOps-сообщество
Anna Ryutina
в идеале делать максимально понятный продукт, чтобы справка с картинками не понадобилась)
Ахах. Это да.
Но реальность, она другая.
источник

DS

Diana Sadykova in DocOps-сообщество
можно ставить гифки
наглядно передают процессы + их переделать проще, чем видео
источник

AR

Anna Ryutina in DocOps-сообщество
гифки тоже сложно поддерживать
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Hartmann
В таком случае, лучше скрины, чем видео. Мне неоднократно приходилось переделывать по 200-300 скринов к каждой документации из-за изменившейся цветовой схемы. Ничё, жив. А представьте перезаписывать видео с озвучкой.
А у разрабов внедрены UI-тесты?)

Если да, скрины автоматизируются

Если нет, пусть внедрят, заодно QA дешевле станет)
источник

H

Hartmann in DocOps-сообщество
Vadim Smelyanskiy
А у разрабов внедрены UI-тесты?)

Если да, скрины автоматизируются

Если нет, пусть внедрят, заодно QA дешевле станет)
Хах. За те деньги, что платили разрабам... Я вообще удивлён, как там хоть что-то работало.
источник

FM

Fox Mulder in DocOps-сообщество
Коллеги, я завел блог, где буду писать о нелегкой жизни техписов. Будет иногда весело, иногда грустно, даже познавательно.
http://zen.yandex.ru/id/5cb37467421c3400b3af4cab
источник

НН

Нац Нац in DocOps-сообщество
Больше блогов!
источник