Re: Creative/Innovative Tech Writing

Subject: Re: Creative/Innovative Tech Writing
From: Robert Lauriston <robert -at- lauriston -dot- com>
To: TECHWR-L Writing <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 30 Aug 2017 13:35:40 -0700

Docs as code / static site generators have been a fad for long enough
that I think usage is declining outside of API documentation and other
contexts where that's the best choice, though I'm still seeing docs
with hundreds of topics displayed as a single long hard-to-navigate
column. For example:

https://kafka.apache.org/0101/documentation.html

Andrew Etter's an enthusiastic booster of that fad. If he'd had more
than one tech writing gig before writing it he might have recognized
that it's not the right tool for every project.

On Wed, Aug 30, 2017 at 1:05 PM, Bee Hanson <beelia -at- pacbell -dot- net> wrote:
> The latest in tech writing is discussed in these three books:
>
> Docs as Code, Anne Gentle
> Modern Technical Writing, Andrew Etter
> Every Page is Page One, Mark Baker
>
> HTH
>
> Bee
>
>
> On Wednesday, August 30, 2017 12:54 PM, D S <seinsfrage -at- gmail -dot- com> wrote:
>
>
> Hi Robert,
>
> Actually, I will be teaching a course and it's supposed to have a section
> on "cutting-edge" trends in technical writing/comm. Ideally, the examples
> would things that make people go, "Wow!"
>
> Thanks!
> Dan
>
> On Wed, Aug 30, 2017 at 2:27 PM, Robert Lauriston <robert -at- lauriston -dot- com>
> wrote:
>
>> What's your goal or problem? Do you have something that's a challenge
>> to explain? Are your docs failing readers in some way?
>>
>> On Wed, Aug 30, 2017 at 12:12 PM, D S <seinsfrage -at- gmail -dot- com> wrote:
>> > I am looking for examples of what one might call creative or innovative
>> > technical writing/communication. I need some inspiration and my
>> > Google-fu
>> > is failing me.
>> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>> Visit TechWhirl for the latest on content technology, content strategy and
>> content development | http://techwhirl.com
>>
>> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>>
>> You are currently subscribed to TECHWR-L as seinsfrage -at- gmail -dot- com -dot-
>>
>> To unsubscribe send a blank email to
>> techwr-l-leave -at- lists -dot- techwr-l -dot- com
>>
>>
>> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
>> http://www.techwhirl.com/email-discussion-groups/ for more resources and
>> info.
>>
>> Looking for articles on Technical Communications? Head over to our online
>> magazine at http://techwhirl.com
>>
>> Looking for the archived Techwr-l email discussions? Search our public
>> email archives @ http://techwr-l.com/archives
>
>>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Visit TechWhirl for the latest on content technology, content strategy and
> content development | http://techwhirl.com
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as beelia -at- pacbell -dot- net -dot-
>
> To unsubscribe send a blank email to
> techwr-l-leave -at- lists -dot- techwr-l -dot- com
>
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
> http://www.techwhirl.com/email-discussion-groups/ for more resources and
> info.
>
> Looking for articles on Technical Communications? Head over to our online
> magazine at http://techwhirl.com
>
> Looking for the archived Techwr-l email discussions? Search our public
> email archives @ http://techwr-l.com/archives
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
Creative/Innovative Tech Writing: From: D S
Re: Creative/Innovative Tech Writing: From: Robert Lauriston
Re: Creative/Innovative Tech Writing: From: D S
Re: Creative/Innovative Tech Writing: From: Bee Hanson

Previous by Author: Re: Creative/Innovative Tech Writing
Next by Author: Strategies for finding gig work?
Previous by Thread: Re: Creative/Innovative Tech Writing


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads