Хотела начать текст с шутки про то, что раз инструкции никто не читает, то и писать их не обязательно. Однако 14 лет работы в IT-сфере доказывают, что это всё же довольно глупая шутка. В современных компаниях (не только в IT, но и особенно в IT!) на документации завязаны практически все процессы от проектирования ПО и ведения бэклога до эксплуатации и поддержки пользователей. Люди со стороны часто не догадываются, что в командах кроме суровых разработчиков, дотошных тестировщиков, внимательных сисадминов, осторожных безопасников и продвинутых девопсов трудятся технические писатели. Как правило, они одновременно суровые, дотошные, внимательные, осторожные и продвинутые, потому что именно на них лежит ответственность как за внутреннюю документацию, так и за корректные, грамотные, лаконичные и точные инструкции для пользователей. И писать желательно без девяти прилагательных в одном предложении, как строчкой выше ?

Сегодня поговорим об этих ребятах, о профессии, о людях в ней и о том, стоит ли войти в айти именно через вакансию техписа?

NB И да, обязательно читайте цитаты членов сообщества техписов — они рассказывают о самом актуальном в профессии из первых рук.

Человечество не умеет жить без мечты. Глобальной, размашистой, такой — чтобы всё или ничего. Люди мечтали летать, как птицы, видеть, как звери, обгонять самых быстрых, создавать золото из олова, не болеть, лечить рак, чинить гены, жить вечно, летать в космос, дотронуться до Луны… Что-то получается, что-то не сразу, что-то — и вовсе нет. Вторую половину XX и пока весь XXI век человечество мечтает…научиться думать. Только не головами, которые как раз мечтают и воплощают мечты в конкретные решения, а железными мозгами: создать компьютеры, обрабатывающие информацию по тому же принципу, что и люди, а то и способные к абстракции и воображению, — обучить машину думать. Это весьма практичная мечта, которая по задумке должна сделать мир лучше и перевернуть медицину, психологию, культуру, искусство, инженерию и почти всё, где мы используем мысль и речь. Догадались, о чём речь?

_{— Стакан наполовину пуст или наполовину полон?
— Мы инженеры. Стакан изготовлен по неверной спецификации.
/Сериал "Мир Дикого Запада" (Westworld)/}

В середине этого января я шла с учёбы домой мимо могилы Ивана Кулибина. Простудный насморк не давал продышаться, я то и дело останавливалась среди гигантских сугробов. У памятника стоял первоклассник с бабушкой, внимательно его разглядывал, а потом спросил: «Кто это?». «Изобретатель», — машинально подумала я. «Великий русский инженер», — ответила бабушка. «Ин-же-нер», — повторил мальчик, кивнул и продолжил рассматривать чертежи на камне.

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

_{Внимание! Конкурс «Технотекст» открывает железную номинацию.} 

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

Мы провели опрос и узнали, какие слова, словечки и высказывания раздражают IT-специалистов. Среди ответов есть неожиданные, но лидер вряд ли кого-то удивит. Как к этому всему относиться? Как к профессиональному жаргону, который есть в каждой специальности. Обычного человека скорее всего покоробят профессионализмы юристов и врачей, но для нас всех короткое и ёмкое слово — формулировка короткой и точной мысли. По крайней мере, очень хочется так думать ;-)

8 февраля — день российской науки. Этот праздник отмечается в Академии Наук, в НИИ, вузах, исследовательских лабораториях по всей стране. Судьба российской науки непростая, всегда переплетённая с историей страны и ею же обусловленная: непростой путь к открытию МГУ, талантливые кулибины (и И.Кулибин) из глубинки, учёные в изгнании, Туполевская шарага, достижения института Гамалеи… Всё смешано, переплетено и влияло и влияет на весь мир. Величие российской науки прежде всего в людях, которые её создают, которые разрабатывают, изобретают, экспериментирую и точно знают, что делают. 

В этот день всегда спорят медики, биологи, инженеры, программисты, филологи, физики, химики — чьи учёные научнее и главнее, кто определял и создавал будущее? Ответ простой: все, каждый — в своей сфере. Предлагаем сегодня собрать российские  открытия и учёных, которые вас вдохновляют, впечатляют, будоражат воображение и влияют (или повлияли) на вас. Напишем эту статью вместе?

Чем активнее мы курируем авторов, тем больше «налипает» опыта и своего, и чужого: кто-то приносит нам шедевры, кто-то — тексты, которые просто невозможно опубликовать. И вроде каждый случай особенный, но все проблемы и находки вполне себе поддаются систематизации. А значит, можно выделить лучшие практики, которые помогут всем сделать тексты лучше. Начнём с базовых моментов, которые, тем не менее, даже у опытных авторов соблюдаются далеко не всегда.

Мои школьные годы пришлись на времена, когда всяческие наказания детей были если не нормой, то «пустяками, делом житейским». Обычно влетало за оценки и хулиганство, реже — за курение. И вот, в один из дней мы устроили в классе бойкот учителю по черчению и подписали созданную против него петицию (на секунду, повод был весомым: он пнул кошку и вышвырнул её за дверь). Через пару дней учителя заменили, а одна девочка с очень строгими родителями пришла в школу только спустя три дня. Оказалось, все эти дни она была заперта дома и много стояла в углу. Повод был сумасбродным: за то что оставила на петиции ФИО и подпись. С тех пор прошло почти 25 лет, и сегодня повод не кажется сумасбродным, а прозорливость отца девочки, учинившего наказание, впечатляет. 

День защиты персональных данных — время не только обсудить взрослые темы, но и поговорить о детях. Как-никак, это наши личные бреши в безопасности (причём не только кибер).

Итак, через 24 часа наступит новый, 2024 год. Красивые цифры:‑) Нам досталось последнее окошко в виртуальном адвент‑календаре. Попробуйте разгадать послание, найти ключ и пришлите его @Exosphere в личку. Первые трое получат в новом году симпатичный мерч от Хабра, остальным нашедшим — плюс в карму:‑)

Ответ опубликован в UPD2.

Написав первый текст в августе 2011, за 12 лет я срослась с Хабром: сперва вела блоги двух компаний, затем левачила партизанскими статьями, и наконец, стала работать в самом Хабре. Меня как автора до Хабра особо и не было — так, разовые заказы на переводы, переделанные песни или двустишия для фирменных календарей как крохотная подработка «чтоб не отвыкнуть». Иногда приходила мысль: а есть ли жизнь меня как автора вне Хабра? А раз есть мысль, нужен эксперимент! За несколько лет я получила 7 публикаций в печатных деловых журналах федерального уровня, публиковалась на популярных площадках рунета (не во всех случаях под своим именем), даже пыталась развивать Дзен (но тут не хватило времени и идей). Мера успешности была разной, но с Хабром не сравнится ни одно из изданий. Итак, рассказываю.

Поставьте запятую в нужном месте

Холодным-холодным декабрём и тёплым-тёплым маем без того неспокойная жизнь модераторов Хабра резко наращивает темп: в Песочнице появляются десятки студенческих публикаций. У нас уже выработалась целая система распознавания таких материалов, но стоит признать, что статьи очень сильно отличаются по уровню: от почти что научных публикаций до содранных с википедии рефератов. А тут ещё и спор внутри команды возник: готовы ли студенты писать на Хабр хорошо и много? Чтобы развеять туман, мы провели небольшое исследование. Сегодня делимся результатом. 

Дуглас Энгельбарт, изобретатель компьютерной мыши, в 2002 году заявил: «Считаю, что мышь по‑прежнему является самым эффективным устройством управления... Когда появились первые сенсорные экраны, все смеялись. Мы знали, что в общих случаях они обладают теми же недостатками, что и световые перья — много движений тратится впустую. Распознавание голоса? Не понимаю, как можно перемещать объект на экране голосом. Как это будет выглядеть: „вверх на пиксель, вправо на два“?». Прошёл 21 год, уже никого не удивляют сенсорные экраны, продвинулось голосовое управление, появилось управление движением глаз, но вот парадокс: разработчики всех этих технологий продолжают пользоваться компьютерной мышкой. Не особо сильно эволюционировав по сравнению с другой электроникой, она по‑прежнему остаётся одним из самых удобных инструментов практически для всех, кто работает за компьютером.

Под катом — дайджест лучших (и странных) материалов по теме. А ещё конкурс.

Сегодня стартует VI конкурс технических статей на Хабре «Технотекст». Команда комьюнити проводит его во второй раз, участвует в четвёртый. Так получилось, что трое из нас — активные авторы Хабра, которые писали для компаний, писали для себя и пишут для блога Хабра. И каждый раз, нажимая «Опубликовать», мы вздрагиваем, а ледяные ладони покрываются мелкими капельками пота. Поэтому мы стараемся делать конкурс с двойным дном: уютным для авторов-участников и познавательным для тех, кто только собирается присоединиться к VII или VIII конкурсу. Сам по себе «Технотекст» — это скорее ярмарка тщеславия точка сбора крутых авторов, способ получить немного признания и лучиков славы. Эти авторы все — победители, потому что написать статью (любую, не только на Хабр), опубликовать её и отвечать за свой текст — это уже подвиг. Потому что не так-то всё просто. 

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

В общем, мы собрали ссылки и советы от коллег. Пользуйтесь, дерзайте, становитесь программистами и развивайтесь. А главное, читайте Хабр, здесь много полезного ;-) 

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

Что относится к DIY? Любой завершённый проект, при создании которого использованы лучшие ресурсы человека: руки и мозг, фантазия и изобретательность, инженерная мысль и рабочий дизайн. Это может быть что угодно: от бумажной настолки с необычной логикой до самодельного автомобиля. Проект может реализовать самоучка или топовый инженер, программист или просто очень хороший родитель — важно, что такие проекты реализуются для целей обучения, развлечения, реализации своих способностей и для пользы людей (а как показывает Хабр, ещё и котов). 

Но, к сожалению, не каждый изобретатель готов рассказать о своём проекте — нередко причина кроется в страхе сесть и начать писать, непонимании, как это — говорить буквами о технике (хотя, по нашему опыту, все с этим отлично справляются). Мы подготовили для вас крошечный гайд, почти план — как писать о DIY-проекте на Хабр.

В первой версии вступления я хотела написать про «Очумелые ручки» и всенародную любовь, но  вспомнила, что у меня есть личная история, которую я никому до сих пор ещё не рассказывала.  В 2011 году я только-только входила в мир технологий: первая статья на Хабр, первый «Hello, World» на С, первая команда Bash… Тогда IT ещё не было культовой сферой, но всё к тому шло. Мой близкий друг подарил мне на новый год самодельную открытку: обычная большая открытка, внутри цветной экран, разъём для зарядки, куча проводов, динамик, а на экране — очень искренняя и личная запись. Для меня это было… странно. Спустя несколько лет наши пути разошлись и открытка с посланием — большая память, которую до сих пор можно включить (качество!). Сейчас я понимаю, что это был первый цифровой DIY в моих руках. Сама я при всей тяге к технике могу только починить, а не создать и не собрать, тем не менее DIY стал самым любимым разделом Хабра — не могу перестать восхищаться тем, что творят некоторые авторы. А ведь на проекты уходит масса сил, времени и денег. Но что-то же ими движет!

Некоторые авторы уже 2–3 года как младше Хабра. 17 лет — большой срок для любого интернет-ресурса и прожить их в онлайне гораздо тяжелее, чем в оффлайне: ежемесячно появляются новые технологии, требования, законы, правила игры и им нужно соответствовать, если хочешь быть современным, актуальным и, что важно, своевременным. Хабр смог! Ежемесячно сюда заходят 12 млн. уникальных пользователей, которые находят что-то нужное, ценное, интересное: туториалы, ответы на вопросы, занимательное чтиво, свежие новости, активные дискуссии, возможность поделиться знаниями и опытом, да хоть новую работу. Чтобы всё это работало, команде Хабра иногда приходится работать 24/7.

Как любой герой, Хабр окружён мифами. Давайте сегодня поговорим про самые странные, прикольные и несправедливые (а что-то может и не миф вовсе)? А ещё под катом маленький конкурс!

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

Не очень давно в одном из комментариев Хабр назвали «хостингом контента» — в том ключе, что здесь собираются статьи совершенно разного качества, уровня и глубины проработки. Тогда нам это определение показалось очень обидным и задевающим, однако, когда эмоции улеглись, оно показалось осмысленным. Действительно, Хабр — это хостинг (накопитель, архив, сборник и т. д.) контента, который отражает временной срез интересов пользователей, их уровня подготовки, мышления, профессионализма. И это хорошо, особенно в свете возможности настройки ленты пользователя.

Однако Хабр как UGC-проект подвержен рискам, связанным с текстами: в наше время автором может оказаться не просто некомпетентный человек, но и нейросеть в руках этого самого человека. При 65-75 статьях в сутки и огромной Песочнице шансов на полную премодерацию не остаётся — это убьёт саму идею Хабра. В общем, идея кураторства витает в воздухе.