приятно

спасибо

Схоронила в Pocket)

Ну вот не скажите, очень много вопросов по очевидным вещам(( Из раздела "А как удалить?", хотя в интерфейсе огромная заметная кнопка с надписью "Удалить"

Да, очевидные кому?

пользователю

Мой опыт: враг документации - менеджеры и госы!

и еще хаос и дедлайны, да

(все еще рекомендую эпохальный пейпер, https://t.me/technicalwriters/57867)

То что очевидно одному не всегда очевидно другому. Даже если в Системе заметная кнопка с надписью "Удалить", то в документации это все равно нужно отразить, некоторые понимают только так

хаос и дедлайны меня не пугают, они неизбежное зло. А вот:
госы - мы не понимаем в ваших докерах, шмокерах. И вообще, вы пользовательскую документацию пишите слишком понятно для пользователя, перепишите.
менеджеры - а что это у вас код разноцветный, исправить на ч.б. Текс какой-то не формализированный - вы писатель или где, учитесь у депутатов. А вот еще задача, мне ее дали год назад, но тебе надо за 1 день сделать всю документацию по проекту.

Лёлик, если человек идиот, то это навсегда ))
Не надо ориентироваться на идиотов. Их и так много.

Я скучаю по старым временем, когда всё ИТ было уделом гиков и умных людей, когда переустановить виндовз могли избранные, а накатить  юникс считалось чем то удивительным.
Тогда люди в ИТ были умнее, требовалось пользоваться мозгом.
А сейчас умные люди объясняют тупым, что такое красная кнопка с надписью Удалить.

Простите, и Вы там до сих пор работаете ?!

Это не про одно место работы, а вообще про все.
На одном из мест работы мне прям прямо заявили - документацию надо писать так, чтобы было непонятно.
===
Я вообще считаю это большой проблемой российской ИТ-индустрии - нежелание меняться, осваивать новые технологии и не бояться экспериментировать.
Причём этому подвержены не только госы или мелкие ИТ-компании, даже крупные ИТ-гиганты боятся отойти от правил: одни считают что пользователь туп (так и есть) и надо писать очевидные вещи, другие - мы не будем использовать в документации комиксы (там где это можно).
===
Использовать docs-as-code? Слишком сложно, будем юзать ворд! Внедрить spring на всей цепочке разработке? Нет! У нас тут легаси на дельфи!

Какой ужас!

А как-то аргументировали важность непонятности?

Я прям слезу пустил, потому как ровно в такой же ситуации нахожусь... Эти люди под 70 лет с выгоревшими глазами, сидят в ГОСах, и пытаются дожить до пенсии с надбавкой. Потому ваши басни про "лучшую жизнь" для них сродни ереси Джордано Бруно или какого Коперника

Ну а вы когда юридические статьи читаете или там законы, вам понятно?
Я вот чувствую себя дебилом, когда читаю фстековские документы. Вот сижу, читаю, не понимаю. Читаю ещё раз. И вроде не дурак ,а вот читаю, не понимаю и чувствую дураком. И законы так же и т.д.
Так делают специально, я тоже так умею и делаю. Когда на отвали или чтобы запутать.

Юридические да, боль и страдания(