TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
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:
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
