{"id":2268,"date":"2019-10-25T04:15:38","date_gmt":"2019-10-25T04:15:38","guid":{"rendered":"https:\/\/blog.hassler.ec\/wp\/?p=2268"},"modified":"2019-09-22T19:35:11","modified_gmt":"2019-09-22T19:35:11","slug":"technical-writing-digest-2","status":"publish","type":"post","link":"https:\/\/blog.hassler.ec\/wp\/2019\/10\/25\/technical-writing-digest-2\/","title":{"rendered":"Technical Writing Digest"},"content":{"rendered":"
\n
\n
\n
<\/div>\n<\/div>\n<\/div>\n
\n
\n
\n
\"\"<\/div>\n<\/div>\n<\/figure>\n<\/div>\n
\n

It\u2019s the end of the month, so it\u2019s time for the technical writing digest! Here are articles and resources that I found interesting and helpful for me.<\/p>\n

Calendar of Events<\/a><\/h1>\n

The KeyContent calendar of events is your source for upcoming conferences and events!<\/p>\n

I gathered the technical writing conferences in my article called \u2018Autumn Technical Writing Conferences<\/a>\u2019. Hurry up, autumn is coming, so buy a ticket in advanced.<\/p>\n

Simplified graphics: Meet the new design style for technical communication<\/a><\/h1>\n

Tech communicators have a problem. Research shows images are a faster and more effective communication tool than words: the human brain processes visuals 60,000 times faster than text (Thermopylae 2014), and 67% of people understand information better when communicated visually (TechSmith 2018). This means it\u2019s vital that, as communicators, we don\u2019t rely on words alone to get our message across effectively.<\/p>\n

Typesetting Markdown \u2014 Part 1: Build Script<\/a><\/h1>\n

Markdown is a document format designed to make writing documents easy. This series describes a way to typeset Markdown content using the powerful typesetting engine ConTeXt.<\/p>\n

Separating document text (the written word) from its appearance (colours, fonts, and layout) makes it possible to create consistent corporate branding, ease documentation maintenance, simplify collaborative real-time editing, reliably embed machine-generated information, simultaneously publish multiple digital formats, and increase productivity.<\/p>\n

You can find other articles of the series on the\u00a0website<\/a>.<\/p>\n

\n
\n
\n
\n
\n
<\/div>\n

\"\"<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/figure>\n

SEO Tips for Technical Writers<\/a><\/h1>\n

Things like DevOps and Agile create more opportunities for cross-team collaboration. And, that\u2019s what is required of any business now \u2014 smoother seamless product delivery. Technical writers are a huge part of this puzzle, and, finally, some real merge is happening due to technical documentation being available online.<\/p>\n

The same rules apply to online docs as to any other form of written content on, say, your corporate website. Meaning that the SEO benefits documentation can bring should be taken seriously.<\/p>\n

In this article, ClickHelp will share SEO tips and lifehacks to help you discover the full potential of online user manuals in this regard.<\/p>\n

New topic in API course: Following agile scrum with documentation projects<\/a><\/h1>\n

Tom Johnson added a new article in his API doc course that expands the notion of docs as code to include not only tools but processes as well. He included an excerpt below and a link to the full article.<\/p>\n

Introducing Markdown and Pandoc<\/a><\/h1>\n

Discover how to write manuscripts in Markdown and translate them with Pandoc into different output formats. You\u2019ll use Markdown to annotate text formatting information with a strong focus on semantic information: you can annotate your text with information about where chapters and sections start, but not how chapter and heading captions should be formatted. As a result, you\u2019ll decouple the structure of a text from how it is visualized and make it easier for you to produce different kinds of output. The same text can easily be formatted as HTML, PDF, or Word documents, with various visual styles, by tools that understand the markup annotations.<\/p>\n<\/div>\n<\/section>\n

\n
\n
\n

Share articles that you find helpful this month in the comment section!<\/p>\n<\/div>\n<\/section>\n

\n

\n

\n

SOURCE:\u00a0https:\/\/medium.com\/technical-writing-is-easy\/technical-writing-digest-94aa6616b30b<\/strong><\/a><\/p>\n

\n

WRITTEN BY<\/p>\n

\n
\n
\"Kesi<\/a><\/div>\n
\n

Kesi Parker<\/a><\/p>\n<\/div>\n

\n
\n
Job position: Freelance Technical Writer. I use ClickHelp for technical writing.<\/span><\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
<\/div>\n
<\/div>\n
\n
\n
\"Technical<\/a><\/div>\n
\n
\n

Technical Writing is Easy<\/a><\/h2>\n
\n
Technical writing is for everyone!<\/span><\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
<\/div>\n

\n

\n

\n","protected":false},"excerpt":{"rendered":"

It\u2019s the end of the month, so it\u2019s time for the technical writing digest! Here are articles and resources that […]<\/p>\n","protected":false},"author":2,"featured_media":2270,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[12,128,47,40],"tags":[],"class_list":["post-2268","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-bloghassler-ec","category-clickhelp","category-medium","category-technical-writer"],"_links":{"self":[{"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/posts\/2268","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/comments?post=2268"}],"version-history":[{"count":1,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/posts\/2268\/revisions"}],"predecessor-version":[{"id":2271,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/posts\/2268\/revisions\/2271"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/media\/2270"}],"wp:attachment":[{"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/media?parent=2268"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/categories?post=2268"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/tags?post=2268"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}