Size: a a a

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

2018 August 11

НН

Нац Нац in DocOps-сообщество
Все так
источник

НН

Нац Нац in DocOps-сообщество
Есть разница
источник

OI

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

D

Daria in DocOps-сообщество
Короче я форкнула репозиторий, но почему-то у меня вместо копии страницы выдает ошибку 404, и я не смогла нагуглить что с этим делать(( https://greenochre.gitlab.io/jekyll
источник

D

Daria in DocOps-сообщество
делала все по этому видосу https://www.youtube.com/watch?v=TWqh9MtT4Bg&feature=youtu.be
источник
2018 August 12

НН

Нац Нац in DocOps-сообщество
Olga Ilchukova
Кстати, почему? Неужели просто из-за того, что на выхах люди заняты чем-то более важным, чем в будни?
Именно
источник

NV

Nick Volynkin in DocOps-сообщество
Daria
Короче я форкнула репозиторий, но почему-то у меня вместо копии страницы выдает ошибку 404, и я не смогла нагуглить что с этим делать(( https://greenochre.gitlab.io/jekyll
Посмотрю завтра, если репозиторий публичный. Или дайте доступ, я там под тем же именем ))
источник

D

Daria in DocOps-сообщество
Nick Volynkin
Посмотрю завтра, если репозиторий публичный. Или дайте доступ, я там под тем же именем ))
Проснулась, а оно само заработало О.о видимо какой-то баг Гитлаба
источник

NV

Nick Volynkin in DocOps-сообщество
Daria
Проснулась, а оно само заработало О.о видимо какой-то баг Гитлаба
Там конвейер со сборкой и публикацией сайта проходит не моментально: с минуту на выполнение и ещё сколько-то в очереди
источник

NV

Nick Volynkin in DocOps-сообщество
Поэтому до первой публикации там 404
источник

D

Daria in DocOps-сообщество
я вчера мину 15 подождала и еще успела погуглить( странно
источник
2018 August 13

ИУ

Илья Улеско in DocOps-сообщество
У меня в ячейках таблицы чеклиста почти всегда располагаются выпадающие списки с значениями. Если критерий не проверен, то ячейка пуста (не выбрано значение из списка). Если критерий был обработан, то ставится значение согласно ситуации. Например, у критерия "актуальность" для страницы справки могут быть такие варианты:
- Актуальна (зелёная подсветка строки)
- Устарели скриншоты (оранжевая подсветка строки)
- Устарело содержимое (оранжевая подсветка строки)
- Требуется редизайн (красная подсветка строки)
- Полностью устарела (красная подсветка строки)

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

ИУ

Илья Улеско in DocOps-сообщество
Чеклисты и defensive writing

Из разговора с Сергеем Егоровым вынес ещё одну идею. Когда результат в 99% случаев положительный, люди забывают действительно проверять его и ставят галочку в чеклисте в 100% случаев.

Есть понятие «defensive programming» — когда мы пишем код так, чтобы приложение было устойчиво к ошибкам и непредвиденным обстоятельствам.

Давайте подумаем про «defensive writing». Как сделать текст устойчивым к ошибкам и искажениям человеческого восприятия? В частности, как защититься от привычки ставить галочку, не проверяя?

Вот пара идей:

— Сделать колонки «да» и «нет», чтобы подумать и отметить осознанно.
— Переформулировать из состояния в действие. Например, состояние — «окно закрыто», а действие — «я подёргал и убедился, что окно закрыто».

А как вы пишете чеклисты? Как бы вы решили эту проблему? Приглашаю поделиться идеями в @docsascode.

#docops_workflow
источник

NV

Nick Volynkin in DocOps-сообщество
Илья Улеско
У меня в ячейках таблицы чеклиста почти всегда располагаются выпадающие списки с значениями. Если критерий не проверен, то ячейка пуста (не выбрано значение из списка). Если критерий был обработан, то ставится значение согласно ситуации. Например, у критерия "актуальность" для страницы справки могут быть такие варианты:
- Актуальна (зелёная подсветка строки)
- Устарели скриншоты (оранжевая подсветка строки)
- Устарело содержимое (оранжевая подсветка строки)
- Требуется редизайн (красная подсветка строки)
- Полностью устарела (красная подсветка строки)

В итоге получается "светофор" на каждый критерий страницы - сразу наглядно видно, какие страницы с проблемами + насколько это критично.
Здорово. Репостну в канал?
источник

ИУ

Илья Улеско in DocOps-сообщество
Nick Volynkin
Здорово. Репостну в канал?
Без проблем
источник

ИЦ

Игорь Цупко in DocOps-сообщество
Оч хорошая тема
источник

NV

Nick Volynkin in DocOps-сообщество
Про чеклисты в частности или defensive writing вообще?
источник

ИЦ

Игорь Цупко in DocOps-сообщество
2
источник

TT

Toni Touch in DocOps-сообщество
Игорь, привет!!
источник

TT

Toni Touch in DocOps-сообщество
Теглайн ведь?)
источник