Technical Writing дайджест #0: новий реліз MadCap Flare, приклади зразкової документації та телеграм-канали для техрайтерів

У випуску: тренди у техрайтингу, сучасні хмарні сервіси для перевірки документації, десятки книжок у PDF та конференції на 2019 рік.

Add to favorites

What's new MS Style guide — спостерігаємо за змінами у Біблії техрайтера.

Confluence — щотижневі апдейти фаворита українських техрайтерів.

MadCap Flare

MadCap Flare 2018 R2 — цього разу новий реліз відверто розчарував: дуже кастомні налаштування безпеки і ніяких нових загальновживаних фіч. Із цікавого тільки мерж бренчів у GIT з UI MadCap Flare.

MadCap Flare 2018 vs. DITA — порівняльна таблиця на сайті MadCap Flare. Мабуть, на 100% об єктивність не претендує, але доволі пізнавально.

A Step-by-Step Guide to Importing Microsoft Word Content into MadCap Flare — покрокова інструкція з імпорту документів як у новій, так і в існуючий проект.

Techcomm tools and trends — Matthew Ellison, лектор і тренер MadCap Flare, розповідає про сучасні хмарні сервіси для перевірки документації вашими колегами. Можна починати слухати з 08:20.

Articles

API Documentation Guidelines — про що варто пам " ятати, коли пишеш API документацію.

Keep It Simple — подкаст про тренди у написанні технічної документації. Можна починати слухати з 08:00.

Comm Tech trends: (Part I , Part II ) — Tom Johnson працює техрайтером в Amazon і веде блог з техрайтингу. Почитайте його думки і спостереження щодо трендів у техрайтингу.

How to avoid being a secretary for engineers — емоційна стаття від Tom Johnson про тяжку долю техрайтерів. Вибачте, тяжку долю «comm tech», як зараз модно говорити :)

Гайд по написанню повідомлень — якщо раптом ви проґавили класну статтю на DOU щодо написання error messages i notifications.

Я дізнався, що існують технічні письменники. Як зрозуміти, що мені це підходить? — для тих, хто тільки придивляється до професії техрайтера.

How A Professional Tech Writer Can Play Your Business? — стислий зміст: «Техрайтери — класні. Наймай, або пожалкуєш» :)

Useful links

!!! Величезне сховище книжок, статей, онлайн інструментів і інших корисних посилань. Зверніть увагу, знизу багато вкладок.

The Top 10 Best Technical Documentation Sites — приклади зразкової документації. Дивимося і насолоджуємося :)

22 API Document Generation Tools — як пише автор, Web and RESTful APIs :)

600+ resources for technical documentation. All in one place — сотні статей на всі випадки життя. Зручна структура і пошук.

5 Great Books on Writing — за версією Ugur Akinci, Sr. Technical Writer в Honeywell. Довіримося його думці.

Telegram channels

Techwriter's Daily — російський канал для техрайтерів. Багато подкастів і статей.

DocOps-чат — доволі живий чат, де можна поставити питання колегам чи взяти участь у гарячій дискусії.

Technical Writing 101 — ще один російський канал, з якоюсь особливою любов'ю до UX.

Technical Writing Blog — власне телеграм-версія сайту clickhelp.com , щоб не пропустити нові матеріали.

Conferences 2019

MEGAComm — 7 лютого, Єрусалим

LocWorld39r — 27-28 лютого, Куала-Лумпур

The Translation and Localization Conference — 29-30 березня, Варшава

Energy Information — 11-12 квітня, Амстердам

Write the Docs Portland — 19-21 травня, Портленд, США

Soap! — 5-7 червня, Краків

LocWorld40 Portuga — 11-13 червня, Ештуріл, Португалія


Дякую колегам зі спільноти Technical writers of Ukraine за допомогу у підготовці матеріалу.

Опубліковано: 24/11/18 @ 08:00
Розділ Блоги

Рекомендуємо:

Геометричний підхід до спрощення логічних схем
DOU Books: 5 різноманітних книг, які радить Микола Котляренко, Business Analyst у SoftServe
DOU Ревізор в Intellias: «Зелений open space на Подолі»
Покрокова інструкція по реєстрації ФОП 3-ї групи ЄП, або Як легально отримувати гроші з-за кордону
PM дайджест #15: Scrum-майстру працюється за кордоном, математика, пояснює проектний трикутник