Космотекст: запускаем лучшие статьи в космос

Привет, это Хабр с буквально космической новостью — у нас стартует конкурс по написанию статей, где 20 лучших мы отправим в... 🛸КОСМОС🛸. Да, прямо в космос-космос. Да, в самый настоящий! Мы делаем такое впервые, поэтому сами в большом предвкушении от процесса и результата. Как мы уже сказали, по итогам конкурса мы выберем 20 статей, а вместе с ними на орбиту улетит еще 60 лучших технических публикаций, которые авторы написали за все почти 20 лет существования Хабра. И для лучшего автора из этих 80 статей у нас с RUVDS есть ☄️ супер приз — экскурсия на Байконур☄️ . Сразу скажем, что участвовать могут только статьи от самостоятельных авторов, а не от компаний. Ну а остальные космические подробности космического конкурса рассказываем ниже. Читать про космотекст

https://habr.com/ru/specials/926358/

#космотекст #статьи_на_хабр #космос #технические_тексты #технический_писатель #программирование #научнопопулярное

Космотекст: запускаем лучшие статьи в космос

Привет, это Хабр с буквально космической новостью — у нас стартует конкурс по написанию статей, где 20 лучших мы отправим в... 🛸КОСМОС🛸. Да, прямо в космос-космос. Да, в самый настоящий! Мы делаем такое впервые, поэтому сами в большом предвкушении от процесса и результата. Как мы уже сказали, по итогам конкурса мы выберем 20 статей, а вместе с ними на орбиту улетит еще 60 лучших технических публикаций, которые авторы написали за все почти 20 лет существования Хабра. И для лучшего автора из этих 80 статей у нас с RUVDS есть ☄️ супер приз — экскурсия на Байконур☄️ . Сразу скажем, что участвовать могут только статьи от самостоятельных авторов, а не от компаний. Ну а остальные космические подробности космического конкурса рассказываем ниже. Читать про космотекст

https://habr.com/ru/specials/926358/

#космотекст #статьи_на_хабр #космос #технические_тексты #технический_писатель #программирование #научнопопулярное

Гарантирует ли техническая грамотность аудитории верную оценку инноваций или как Хабр USB-С хоронил

Я пишу на Хабре довольно давно и иногда натыкаюсь на собственные же старые посты. Недавно попалась вот эта заметка (по другому ее и не назовешь) от 2013 г. про скорое появление USB-С . Ее прочитало 50 тысяч, она получил 65+ и — самое главное — 170 комментариев (ох, вот он старый Хабр, где даже два абзаца текста могли быть встречены вот так!). И, как обычно — комментарии оказались самим ценным. Сегодня, спустя 12 лет, когда универсальность USB-С признала даже Apple, мне показалось любопытным проанализировать, как технически грамотная и продвинутая аудитория (а какая же она еще на Хабре!) восприняла эту информацию тогда и увидела перспективы интерфейса. Спойлер: только 17% комментариев проявили поддержу или технический интерес к новому интерфейсу. Интересно? Поехали!

https://habr.com/ru/companies/timeweb/articles/920490/

#железо #usbc #ipad #экспертиза #прогнозы #аудитория_хабрахабра #технические_тексты #грамотная_аудитория #timeweb_статьи

[Перевод] Как написать грамотный гайд: правила для техписов и разрабов

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

https://habr.com/ru/companies/netologyru/articles/873674/

#гайд #руководство #техпис #технический_писатель #техническая_документация #технические_тексты #технический_гайд #формулировка #хорошие_примеры #как_надо_писать

Документы под контролем: Как выбрать идеальную платформу и не сойти с ума

Запутались в выборе платформы для работы с документацией? Функций море, терминология запутанная, а вариантов столько, что глаза разбегаются—даже опытные специалисты порой теряются! Мы собрали для вас 10 ключевых критериев, которые помогут найти идеальную систему управления документацией без лишней головной боли. Давайте разберёмся вместе!

https://habr.com/ru/companies/documenterra/articles/863096/

#базы_знаний #документация #управление_знаниями #выбор_платформы #инструменты_для_работы #продуктовая_документация #технический_писатель #технические_тексты

Почему светофор важнее Шекспира? Про примечания в технических текстах

У химиков есть известная байка, которую они любят рассказывать молодому поколению. Главный герой этой истории — студент, который пошагово воспроизводил методику одного химического эксперимента из учебника. Он старательно выполнил очередной шаг «добавьте азотную кислоту» и... в лаборатории прогремел взрыв! Когда впоследствии стали разбираться, в чём же дело, выяснилось, что на следующей странице учебника было написано: «... медленно, по каплям». Примечания и уточнения — очень важный элемент любого технического и научного текста. В любом документе фрагменты текста можно ранжировать по важности и критичности излагаемых сведений. Бывает просто обычный текст, который течёт себе ровно, как спокойная равнинная река. Бывают фрагменты с дополнительной, необязательной, уточняющей информацией: автору хотелось их добавить в текст, но они плохо укладываются в основную логику изложения материала. А ещё бывают критичные замечания и уточнения, которые обязательно должны быть обвешаны мигающими сигнальными огнями, сиренами, хлопушками и прочими средствами привлечения внимания читателя. Как же лучше оформлять примечания в технических текстах? В статье расскажу вам про пять несложных правил оформления примечаний и уточнений в технических текстах.

https://habr.com/ru/articles/822145/

#примечания #примечания_к_техническим_текстам #техническая_документация #примечания_к_документации #уточнения #правила_оформления_примечаний #технические_тексты #пользовательская_документация #светофор #технические_писатели