Заметки технического писателя
189 subscribers
231 photos
15 videos
52 links
Технический писатель. В настоящий момент работаю в авиационной отрасли.
Download Telegram
В эту пятницу больше хочется спать, чем работать. Световой день увеличился почти на час, а все равно. Лихорадочно думаю, почему. Вспоминаю, что у меня закончились определенные витамины. Как-то странно это обстоятельство по времени совпало с моей большой сонливостью. Чувствую себя змеей, ибо на работу не пришла, а приползла. А ведь по китайскому календарю это пресмыкающееся начнет доминировать только через несколько дней. Витамины куплю завтра однозначно.

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

Надо работать. Рабочий день только начался, а мне уже хочется обнять одну мягкую урчащую тушку. Котик у меня очень габаритный, весит 5,6-5,8 кг - и это его нормальный вес, без ожирения. Потому да, там есть что обнять и погладить. Но. Надо. Работать. Работать. Работать. От мыслей о коте отвлекает работа с приборами. Надолго ли? 🤔

#мысливслух #рабочее
5👍1🤝1
Мне кажется, что техническому писателю надо не только уметь писать, общаться с коллегами и знать базовые понятия, связанные с непосредственной работой, но и уметь находить интересные моменты в самых рутинных вещах. Приведу пример из своего рабочего процесса.

Зачастую начальник отдела просит меня найти такой-то документ архивной версии (у меня стоит специальная программа, позволяющая не беспокоить лишний раз работников архива) и распечатать из него листы, содержащие определённые сведения. Рутина? Да. Однако через такие поручения приходит лучшее понимание комплекта документации ЕСКД.

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

Скоро будет три года, как работаю на авиационном предприятии. Но уверена, что даже через 23 года (если такое чудо вдруг случится) я буду находить для себя что-то новое и удивительное.

#рабочее
👍5
Что лучше: интуитивно понятный интерфейс или четкая многостраничная инструкция?

Ответ на данный вопрос зависит от контекста и текущих потребностей.

Интуитивно понятный интерфейс:

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

:
Сложнее реализовать для сложных систем со множеством функций.
Не всегда может охватить все возможные сценарии использования.

2. Четкая многостраничная инструкция:

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

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

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

Когда есть вдохновение, писать легко и приятно, кажется, сам Бог управляет твоей рукой. А когда его нет, а писать НАДО, потому что работа/обязательства и пр.?

Сменить обстановку не всегда получается, так как пресловутые 5/2 никто не отменял. Удаленка практикуется только в самых исключительных случаях. Иногда "подзарядиться" получается, глянув в окно - повезло с красивым видом.

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

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

Так как проблема для меня актуальна, периодически ищу в интернете советы, как ее решить. Распространенный совет - медитация и прогулки. Медитацию не практикую, так как она удерживает внутри не только положительные, но и отрицательные эмоции. Прогулки в моем случае хороши либо до, либо после окончания рабочего времени, а еще лучше - в выходные.

Еще интересный совет - установить таймер и работать не отвлекаясь. Лично я буду думать не о тексте, а о том, как уменьшается значение времени на экране телефона...

На самом деле, главное спасение в период невдохновения, когда нет, казалось бы, никакого внутреннего ресурса, - это работь через силу, как получается, с ошибками, с перерывами на что-нибудь, но работать. Правило 10 000 часов, после которых приходит некоторый автоматизм, подтверждено жизнью и более чем 10 годами непрерывного написания текстов различного назначения.

#мысли_вслух
👍41
Представляю еще одни советы по вычитке текста. Вдруг кому пригодятся.

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

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

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

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

✏️ Сделайте паузы перед итерациями вычитки, хотя бы 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