Заметки технического писателя
189 subscribers
231 photos
15 videos
52 links
Технический писатель. В настоящий момент работаю в авиационной отрасли.
Download Telegram
Представляю еще одни советы по вычитке текста. Вдруг кому пригодятся.

#как_работать_с_текстом
Пиши сокращай проверяй

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

✏️ Вычитывайте вслух. Незаметные глазу шероховатости очень хорошо слышно. Если спотыкаетесь — это верный признак, что лучше упростить предложение.

✏️ Когда вычитываете, представляйте себя в разных ролях: новичок, продвинутый пользователь, редактор.

✏️ Сделайте паузы перед итерациями вычитки, хотя бы 30 минут. И в следующий подход документ будет восприниматься свежим взглядом. Не зря говорят: «утро вечера мудренее».

✏️ Обманите мозг. Прочитайте статью с конца. Так легче заметить ошибки — ум идет не по проторенной дорожке. Конечно, этот вариант не подойдет, когда вы проверяете структуру документа, но вот найти канцеляриты или орфографические ошибки точно можно.

✏️ И наконец, прислушивайтесь к своему внутреннему голосу. Если вам кажется, что что-то не так — вам не кажется. Попробуйте переписать или перефразировать ваше предложение.

Дополняйте наш список и делитесь своими советами в комментариях.

#давайте_лайфхак
👍9
2 февраля - день технического писателя! 📝🤔😊

Писать документацию — это искусство, требующее не только мастерства слова, но и глубокого понимания технологий. Умение "перевести с русского на русский" превращает сложные идеи в доступные и понятные материалы, делая мир технологий более ясным и дружелюбным.

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

Потому поздравляю всех технических писателей с профессиональным праздником. Желаю удачи во всех начинаниях, интересных тем для написания и, конечно же, пользователей, которые оценят ваш труд!

🎂🍰🧁🍭🍮🍸🍷🍾🍾🥂
🎉12
Когда я только переехала в Петербург, искренне не понимала, почему в местных пабликах необыкновенные восторги по поводу того, что небо голубое и светит солнце. Не могла понять коллег: зачем вообще говорить о Солнце, это же само собой разумеющееся. Сытый голодного не разумел, ибо на родине, как нас учили: "Солнца больше, чем в Сочи". И да, оно у нас было круглый год. Сегодня так лень было идти на работу. Плюнула на все, вышла на 20 минут позже, а чтобы не опоздать, добиралась на такси. Не жалею, зато "впитала" в себя голубое небо, непогасшие фонари, снег и мороз -10. Неужели опетербуржелась? 🤔
😁6
Перечитывая любимую книгу спустя два года, заново сопереживаешь героям повествования, вновь погружась в знакомый, но в то же время несколько подзабытый сюжет.

Перечитывая документацию спустя два года, думаешь: КАК. ЭТО. ПОПАЛО. В АРХИВ. Закрываешь. (Отрицание). Открываешь, всматриваешься и смиряешься (Принятие). Вот так быстро проскакивают Все стадии проживания прошлого опыта пролетают максимум минут за 5. И речь здесь не о непрофессионализме, а о возрастающем перфекционизме: с каждым новым документом стиль и насмотренность все лучше, а потому все прошлое со временем хочется переделать.

#рабочее
👍43
Человеческий фактор в авиации. Часть 1 ✈️

По определению ИКАО (международная организация гражданской авиации) человеческий фактор - это наука о людях в той обстановке, в которой они живут и трудятся, об их взаимодействии с машинами, процедурами и окружающей средой (обстановкой), а также о взаимодействии людей между собой.

По статистике человеческий фактор определяет около 80 % всех авиационных происшествий 💥

Для исследования влияния человеческого фактора на безопасность полетов, используют концептуальную модель «SHEL»

Модель «SHEL» (аббревиатура составлена из начальных букв английских названий ее составных элементов):
Software - программное обеспечение;
Hardware - техника;
Environment - окружающая среда;
Liveware - человек.

Продолжение 7.02.2025
4
Человеческий фактор в авиации. Часть 2 ✈️

Рассмотрим элементы модели SHEL

В центре модели находится человек 🧍‍♂️- наиболее гибкий, способный к адаптации и самый важный элемент авиационной системы.
Остальные компоненты системы должны быть максимально подстроены под него, во избежание нежелательного напряжения и возможных сбоев в системе.

❗️Для обеспечения такой совместимости важно знать характерные особенности узлового компонента системы.

К более важным характеристикам относятся:
1️⃣Физические размеры и форма. При проектировании любого рабочего места и большей части оборудования решающую роль играют данные о размерах и параметрах движения различных частей тела.
2️⃣Физиологические потребности: потребности человека в еде, воде и кислороде и т.д.
3️⃣Особенности восприятия информации. Человек реагирует на внешние раздражители с помощью анализаторов.
4️⃣Обработка информации. Игнорирование возможностей системы обработки информации человеком зачастую приводит к несовершенству конструкций приборов и систем предупреждения об опасности.
5️⃣Особенности реакции человека на полученную информацию. Как только информация воспринята органами чувств и об-работана, мышцам передается сигнал о начале движения. Необходимо иметь представление о необходимых побудительных силах и направлении движения.
6️⃣Условия окружающей среды. Температура, давление, влажность, шум, время дня, степень освещенности оказывают влияние на труд и самочувствие человека. Высота, замкнутое пространство, стрессовые или монотонные условия работы также могут влиять на работоспособность человека.

Продолжение 13.02.2025
1
9 февраля - День гражданской авиации 🛬🛫✈️

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

Теперь же хожу по разным авиационным выставкам. В итоге посетила (и всем рекомендую сделать это тоже!):

Выставка 100 лет гражданской авиации России. Санкт-Петербург, терминал "Пулково-2" улица Стартовая д.17, стр.1.
Дом авиаторов, г. Всеволожск, Колтушское шоссе, 40.
Музей гражданской авиации, г. Ульяновск, Авиационная улица, д. 20А.
Центральный дом авиации и космонавтики ДОСААФ России, г. Москва, Красноармейская улица, д. 4.

Была в других местах - они не полностью посвящены авиации, но были представлены отдельные экспозиции.

✈️Гражданская авиация играет ключевую роль в обеспечении транспортной доступности, способствует развитию туризма и международной торговли, а также служит важным инструментом в экстренных ситуациях, таких как доставка гуманитарной помощи или эвакуация.

✈️Праздник стал символом профессионального единства и гордости за свою работу для многих людей, связанных с авиацией — от пилотов и бортпроводников до инженеров и диспетчеров.

🛫🛬✈️🥂
2👍2
Я не знала, что такое метеозависимость, пока в полной мере не ощутила ее на себе. Но то, что у нас есть метеозависимые самолеты и автомобили (китайские), изрядно удивило.

Про автомобили ничего сказать не могу, для эксплуатации самолетов, существуют ограничения для выполнению взлетов и посадок, если давление слишком высокое. Существует специальные процедуры по коррекции давления. Потому что у многих воздушных судов ограничения 1050 гектопаскалей. 🤍 Например, Superjet 100. Именно поэтому появились новости о массовой отмене рейсов из аэропорта Пулково.
😁4
Как неверный UX привел к пожару в Соборе Парижской Богоматери?

Я думаю, многие в курсе о том, что недавно в Париже торжественно открыли отреставрированный после большого пожара Собор Нотр-Дам-де-Пари. Однако знаете ли вы, что пожар не успели вовремя потушить, так как новый охранник получил от сигнализации код ZDA-110-3-15-1 (UX в чистом виде!), указывающий на точное место возгорания. Но охранник не смог его интерпретировать и 30 минут просто искал, где это место. За это время пожар успел разгореться и потушить его уже не получилось. На реставрацию потратили более 900 миллионов долларов. Хорошая цена за плохой UI/UX, не правда ли?

Как французское национальное достояние, Нотр-Дам имел собственную систему пожарной сигнализации. Это была довольно продвинутая система, которая была разработана и спроектирована специально для церкви. Поэтому, когда пожар начал развиваться — предположительно как тлеющий огонь — она подала сигнал тревоги.

Исторически сложилось, система Собора не была подключена напрямую к службе пожарных, а подавала сигнал на пульт собственной охраны. Выдаваемый на пульте код в цифренно-буквенном формате, в представлении инженеров, проектировавших систему, однозначно определял расположение сработавшего датчика. Но это для обученных сотрудников. Для критических случаев предполагался небольшой справочник с расшифровкой кодировки, который куда-то положили.

И все штатно работало. Но в тот день дежурил новый охранник — это был его 3-й день на посту — обучить которого интерпретации забыли или не успели.

После срабатывания сигнализации в 18:20 сотрудник получил код «Attic Nave Sacristy ZDA-110-3-15-1 aspirating framework», но не смог его правильно истолковать. Взволнованный, он позвонил своему менеджеру, но тот не взял (!) трубку. Охранник как смог самостоятельно интерпретировал сигнал и послал стражу на чердак небольшой ризницы, которая находится рядом с самой церковью.

А пожар тем временем разгорался под крышей основного здания. Прошло 25 минут, прежде чем ошибка была обнаружена (видимо перезвонил менеджер и помог интерпретировать код). Все это время охрана склонялась к версии о ложном срабатывании.

После правильной интерпретации охранник немедленно отправился к потолку церкви. Обнаружив огонь, он быстро (ключевое слово во всей этой истории) дал указание собственному подразделению пожарной охраны церкви позвонить в пожарную службу. К этому моменту прошло уже 30 минут с момента срабатывания первой сигнализации, и 25 из них были потрачены впустую на поиски пожара не в том месте.

Что случилось дальше с Собором Парижской Богоматери, думаю, вы уже знаете. А если бы UX-текст был бы однозначно понятным без необходимости рыться в толстенных справочниках, теряя на этом драгоценное время..., но история не знает сослагательных наклонений.
🔥53
Человеческий фактор в авиации. Часть 3 ✈️

«Человек-техника» (L-H).


🧑‍💻 Вопрос о взаимосвязи «человек-техника» возникает, когда речь идет о системах интерфейса человека и машины. Например, при проектировании кресел с учетом характеристик человеческого тела, дисплеев с учетом возможностей усвоения информации пользователем; а также органов управления, их кодирования и размещения.

Данный вопрос изучается в дисциплине «эргономика», которая рассматривает трудовую деятельность человека в системе «человек - техника - среда» с целью обеспечения ее эффективности, безопасности и комфорта с учётом физических и психических особенностей человеческого организма. В авиации с первых дней и в течение многих лет основная эргономическая проблема заключалась в разработке общих принципов конструирования устройств, отображения данных и органов управления кабины пилота.

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

Продолжение 14.02.2025
2
Человеческий фактор в авиации. Часть 4 ✈️

«Человек - программное обеспечение» (L-S).


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

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

В авиации очень важна последовательность выполняемых процедур на основе грамотных и понятно написанных документов 📑

Продолжение 20.02.2025
3
Давайте подумаем, о чем болтают эти два весельчака ✈️✈️

Может, о повышении налета
Или про новые маршруты в теплые страны
Или рассказывают байки, которые слышали от своих пилотов

На самом деле, на фото вы видите погрузку какого-то груза в фюзеляж грузовых самолетов. Думаю, по объему туда поместится почти все ❗️

#юмор
😁6
Приключения документации на предприятии, если это был бы литературный роман 📝✈️🟰Часть 1

Биографический роман:
Документация родилась.
Документация прошла инстанции (метролог, нормоконтролер, военная приемка).
Документация в архиве.

Трагический роман:
Документация рождается с трудом.
Начальник вносит правки именно сейчас, потому что так решил.
Начинаем все с нуля.

Драматический роман:
Документация рождалась параллельно с многочисленными обсуждениями нюансов.
Бесконечные правки одного по одному.
Правки откатываем назад.

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

Продолжение 25.02.2025

#юмор #приключения_документации_роман
8
Forwarded from Пилот Компот
Media is too big
VIEW IN TELEGRAM
🙌Добрый день
Заснял для вас закат СОЛНЫШКА.
Всем хороших выходных 👏

Как думаете, куда прилетел ?
Please open Telegram to view this post
VIEW IN TELEGRAM
2
Человеческий фактор в авиации. Часть 5 ✈️

«Человек - окружающая среда» (L-E).


В этот блок входят физические условия, влияющие на деятельность человека.

❗️Основные факторы блока обусловленны шумовыми эффектами, вибрацией, недостаточным или избыточным освещением, температурой (слишком жарко или слишком холодно) с особенностями погодно-климатического характера (дождь, снег, туман).

📢 Так, например, негативными последствиями шумового воздействия являются:

- повышение утомляемости;
- снижение концентрации внимания;
- искажение речевого обмена информацией;
- снижение порога слышимости;
- возникновение нервных и сердечно-сосудистых заболеваний.

💡 Не менее значимыми являются условия освещенности, которые влияют на остроту зрения. При повышении освещенности острота зрения работника улучшается. Избыток освещенности приводит к резкой усталости глаз и, следовательно, увеличению утомляемости. Ослепительные блики и свет вызывают у человека дискомфорт и резко ухудшают способность увидеть важные для него предметы. Недостаток освещенности приводит к снижению остроты зрения.

🌦️ На работоспособность человека влияет также температура окружающей среды. Комфортной является температура 20...22 °С при относительной влажности 40...60 % и скорости движения воздуха до 2 м/с. Такие условия оптимальны для состояния покоя или очень легкой физической работы. При повышении температуры окружающей среды выше 25 °С может возникнуть физическое утомление, выше 30 °С – ухудшение умственной деятельности, на фоне которых замедляется реакция, появляются ошибки. Холод увеличивает время реагирования и затормаживает движения. При температуре ниже 16 °С ухудшается гибкость рук и пальцев, а при температуре 13 °С показатель гибкости рук уменьшается на 50 %.

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

Продолжение 21.02.2025
3👍1
Человеческий фактор в авиации. Часть 6 ✈️

L-L «человек - человек» (
на мой взгляд самое сложное взаимодействие)

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

При взаимодействии L-L в модели SHEL важно учитывать различия в ролях, задачах, навыках, опыте и предпочтениях каждого члена команды.

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

❗️ *Особая ситуация – ситуация, возникающая в полете в результате воздействия неблагоприятных факторов или их сочетаний и приводящая к снижению безопасности полета.

Деятельностные

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

Временные характеристики:
-превышение допустимых значений обнаружения и опознания, принятия решения;
-завершения парирующих действий.

Согласованность действий:
-действия не согласованные с действиями других членов экипажа по составу, последовательности и точности;
-несанкционированные попытки выполнения действий за другого члена экипажа.

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

Коммуникативные

Характеристика радиообмена:
-отсутствие сообщений, запаздывающие сообщения об опознании вида особой ситуации, принятом решении, выполненных действиях;
-неверное (поспешное) сообщение о виде особой ситуации и источнике отказа авиационной техники;
-неконкретность, неопределенность сообщения;
-неправильное восприятие сообщения;
-безадресность команд;
выдача взаимоисключающих команд;
-большое количество одинаковых запросов;
-большое количество одновременных выходов эфир двух и более членов экипажа с потерей информации;
-чрезмерно высокая плотность радиообмена.

Психологические

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

Психологическая совместимость:
-преднамеренное невыполнение команд;
-возникновение конфликтных ситуаций;
-взаимная неприязнь;
-неудовлетворенность совместной работой.

Особенности поведения членов экипажа:
-паника;
-ступорозное состояние;
-навязывание собственного неправильного решения.

Для ОВД и при ТО ВС недостатки в коммуникациях могут проявляться аналогично рассмотренным для экипажа ВС.
1
✈️🇷🇺🎉🌹Дорогие мужчины, поздравляю вас с Днём защитника Отечества! 🇷🇺✈️🎉🌹

Пусть вашей визитной карточкой остается мужество, целеустремленность и уверенность в себе! Желаю не терять бодрости духа и твёрдости характера, всегда стоять на защите своей семьи и своих принципов!💐💐💐
👍8
В пятницу 22 февраля отмечала с коллегами предстоящий праздник. Заказали пиццу🍕🍕🍕🍕: три стандартные и одну выдуманную нейросетью. Хотя коробки не были подписаны, все без труда догадались, какую именно выдумал искусственный интеллект. В этой пицце ингридиенты были намешаны хаотично: где-то слева валялся огромный кружок помидора🍅, правее - кольца лука🧅, бекон🥓 (тоже цельным куском!) - еще правее, еще далее - немного сыра🧀...Было общее ощущение несогласованности как визуальной композиции, так и вкуса. Зато все поняли, что искусственному интеллекту пока рано в повара 👨‍🍳.

А еще играли в игру (всем рекомендую), напоминающую известую "Море слов". В отличие от оригинальной игры, в нашей карточки были самодельные и связанные с авиационной тематикой✈️. Например, было слово "трап". И коллега, у которого была эта карточка, объяснял примерно так (дословно не помню): "Это то, что подают пассажирам при посадке".

Было весело. Пятница была рабочей лишь формально.
🔥6
Приключения документации на предприятии, если это был бы литературный роман 📝✈️🟰Часть 2

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

Хоррор-роман:
Документация прошла все проверки.
Документация легла в архив.
Вылезла критическая правка после отправки изделия заказчику, документацию надо скорректировать.

Мистический роман:
Документация делалась интуитивно: сегодня удачный день, завтра неудачный, послезавтра опять удачный...
Документация легла в архив.
Выяснилось, что документация задержана на пути к архиву из-за технических испытаний изделия у заказчика и живет своей "потусторонней" жизнью.

Кибер-панк роман:
Документация рождалась в муках.
Документация уже сдана в архив, скоро будет отображена в базе.
Error. No Error. Game over or not?

Продолжение 4.03.2025

#юмор #приключения_документации_роман
👍4👎1