#book  глоссарий ITIL 3v  Rus-Engl

#book   большой англо-русский толковый научно-технический словарь IT и радиотехн 2016 Кочергин. в 9 томах

Ставьте важное вперёд.

Пишет Александр Парень (@SashP84):
Почитываю блоги про авицию. Один из действующих лётчиков разбирает и публикует всякие материалы по тем или иным моментам. Так вот, все помнят, что были две катастрофы Boeing 737MAX, там выяснилось, что была недоработка ПО, но в данном материале пилот отмечает, что оказывается на заметку "Note" в инструкциях никто не обращает внимания.
https://denokan.livejournal.com/207143.html

По ссылке обсуждают инструкцию к самолёту. В ней текст с такой структурой:

Сделайте А
Note: но если выполнено условие X, сначала сделайте Б, иначе случится что-нибудь плохое. (Сделать Б после А технически невозможно).

В критической ситуации человек читает и выполняет первую инструкцию, а потом уже находит вторую. Или не находит. Иногда это приводит к катастрофе.

Вывод автора блога: блок нужно называть Warning, а не Note, и ставить перед остальным текстом. Так у читателя будет меньше шансов пропустить этот блок и больше шансов спасти самолёт.

Не все пишут инструкции к самолётам, но правило-то работает везде. Важное — вперёд.

Коллеги, а подскажите хороший и регулярно обновляемый докер-образ Sphinx?

вот этот вроде норм ddidier/sphinx-doc

раньше его использовала, но теперь только свой

Спасибо, опробую

2 мес назад апдейт

Мне ваша фраза прям засела как-то, не знаю почему.

Вот тут тоже в документации хороший пример встретил.

Примеряю на себя и не понимаю как можно писать документацию всегда серьёзно и с кислыми щами

Simply use!

На прошлом WTD Prague был целый доклад по то что не надо писать simply.

Всё понимаю, но всё равно грустно :)

+

Simply deploy a k8s cluster.

Simply move your app to cloud.

Simply rewrite your app in this new language.

Не бывает изи

Пушо не всем одинаково изи

не пишите изи, ради всего святого

Нельзя знать кому изи кому нет

а если бывает, то