Re: Leading and Bleeding Edge?

Subject: Re: Leading and Bleeding Edge?
From: Tom Johnson <tomjohnson1492 -at- gmail -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 4 Jan 2016 15:23:23 -0800

Chris wrote: "The ability to read code and document APIs (RESTful, etc.)
is currently in vogue ...."

I recently wrote a post explaining on the ripple effect of API growth on
the tech comm community. You can read it here:
http://bit.ly/2016techcommtrends

I try to address some of the trends that Lonie was asking about (the "leading
and bleeding edge technologies technical
writers use to create publications and documentation"). I mention Github,
static site generators, and API-based CMS tools.

The problem with bleeding edge tools is that they rarely satisfy the
requirements placed on tech writers. People want modern-looking,
interactive websites. Then they also explain on that they need PDF
generation, translation, multi-edit capabilities, single source generation,
workflows, and document statuses, etc. By the time the list of requirements
is finalized, about the only tools that satisfy them are more traditional
tech comm tools.

Tom

---------------------
blog: idratherbewriting.com
twitter: tomjohnson
email: tomjohnson1492 -at- gmail -dot- com
cell: 408-540-8562

On Mon, Jan 4, 2016 at 9:34 AM, Chris Morton <salt -dot- morton -at- gmail -dot- com> wrote:

> The ability to read code and document APIs (RESTful, etc.) is currently in
> vogue; I've had to pass a couple of those opportunities due to lack of
> hands-on experience (although I'm certain I could quickly learn). Speaking
> of adaptability, there are some useful tutorials on YouTube, but one has to
> vet them carefully.
>
> There is still a call for Framemaker skills; I used Classroom In a Book to
> get myself up-to-speed on one project.
>
> I've also had to recently pass on a gig that involved DITAâagain because of
> lack of any actual experience (being an autodidact doesn't count).
>
> Content reusability/repurposing is a big deal today; tools like MadCap
> Flare and Atlassian Confluence seem to rule here. I don't know about
> Atlassian, but MadCap has a lot of free Flare video tutorials and such on
> their site.
>
> Chris Morton
>
>
>
>
> On Mon, Jan 4, 2016 at 11:42 AM, Lonie McMichael <loniemc -at- gmail -dot- com>
> wrote:
>
> > Hello, Folks:
> >
> > I searched the archives and have not found any recent conversations on
> this
> > topic. If it has already been discussed, I would appreciate being pointed
> > towards the thread.
> >
> > I am teaching Tools for Technical Writers this semester. My students will
> > be writing reports on leading and bleeding edge technologies technical
> > writers used to CREATE publications and documentation. Unfortunately, I
> > only have the old standards (Adobe, Microsoft, etc.) to use in class.
> > However, I can make them aware of what they might be facing when they
> leave
> > school. Also, I do teach them what I call "technological adaptability":
> how
> > to learn new technologies and software packages quickly.
> >
> > Since this list is the best place I know for such information, right now
> --
> > Jan 2016, in your company and your area, what software are you using to
> > create your documentation? Are you exploring any new publication software
> > or technologies? Do you see some significant changes coming in the
> > relatively near future?
> >
> > Thanks for any input!
> >
> > --Lonie McMichael
> > Senior Instructor
> > UCCS
> >
> >
> >
> >
> > <
> >
> https://www.avast.com/sig-email?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=webmail
> > >
> > This
> > email has been sent from a virus-free computer protected by Avast.
> > www.avast.com
> > <
> >
> https://www.avast.com/sig-email?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=webmail
> > >
> > <#DDB4FAA8-2DD7-40BB-A1B8-4E2AA1F9FDF2>
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> > Visit TechWhirl for the latest on content technology, content strategy
> and
> > content development | http://techwhirl.com
> >
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > You are currently subscribed to TECHWR-L as salt -dot- morton -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 tomjohnson1492 -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 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


Follow-Ups:

References:
Leading and Bleeding Edge?: From: Lonie McMichael
Re: Leading and Bleeding Edge?: From: Chris Morton

Previous by Author: TECHWR_L Announcement: ICC is the conference for communicators who work with intelligent content
Next by Author: Re: Leading and Bleeding Edge?
Previous by Thread: Re: Leading and Bleeding Edge?
Next by Thread: Re: Leading and Bleeding Edge?


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

Sponsored Ads


Sponsored Ads