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.
Re: Using jira for documentation development workflows
Subject:Re: Using jira for documentation development workflows From:Shawn <shawn -at- cohodata -dot- com> To:Robert Lauriston <robert -at- lauriston -dot- com> Date:Wed, 30 Jul 2014 17:08:26 -0700
Sorry for my silence, all.
I had forgotten about this thread.
Thanks so much for the replies. I shall read them this evening.
> On Fri, Jul 11, 2014 at 1:04 PM, Shawn <shawn -at- cohodata -dot- com> wrote:
> > Kevin (et al),
> > I noticed that you mentioned "Jira" and "documentation" in a single
> > thought. Kind of a rarity, it seems.
> > I changed the subject so that I am not hijacking the other thread. :)
> > Being the sole tech writer in a hard-core Linux engineering team, Jira is
> > pretty central to all the development work here. Unfortunately, the
> > Jira configuration doesn't really meet my documentation workflow
> > requirements. Additionally, I have found very little about this subject
> > the Web.
> > Can you/anyone offer advice (or web URLs) on how best to use Jira for
> > technical writing?
> > Thank you,
> > Shawn
> > On Mon, Jun 23, 2014 at 12:00 PM, McLauchlan, Kevin <
> > Kevin -dot- McLauchlan -at- safenet-inc -dot- com> wrote:
> >> Starting from a history of waterfall-ish development, and after more
> >> two years in-progress, we are in water-agile-fall(**), trying to get to
> >> agile, and one outcome of that is that EVERY new thing I add to the
> docs is
> >> supposed to be captured as some kind of Jira issue (story, bug,
> >> So, I never used to ask permission, and now I still don't, directly, but
> >> the indirect effect is that that's how it now works.
> >> I have (as we say around here) a whack of issues in my backlog that
> >> assigned to any sprint, that aren't supposed to be implemented unless
> >> got nothing to do. That doesn't happen, of course.
> >> In reality, they'll get snuck into a DOC sprint that we writers are
> >> assigning to ourselves, packed among structural and other sanctioned
> >> stories and issues. But I thought I'd check which way the winds blow
> >> the rest of y'all*. :-)
> >> (*I'm not southern - I just like to say "y'all" sometimes)
> >> (**actually, some product teams, here, are frighteningly agile, while
> >> others are still getting onboard - I'm in two that are at different
> >> along that spectrum; if I had rhythm, you could call what I do
> >> but no )
> >> -----Original Message-----
> >> From: techwr-l-bounces+kevin.mclauchlan=
> safenet-inc -dot- com -at- lists -dot- techwr-l -dot- com
> >> [mailto:techwr-l-bounces+kevin.mclauchlan=
> >> safenet-inc -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf Of Mike Starr
> >> Sent: June-20-14 6:39 PM
> >> To: techwr-l -at- lists -dot- techwr-l -dot- com
> >> Subject: Re: What is not mandated is forbidden
> >> I never ask permission to put something into a document that can not
> >> help the user but help reduce support queries. If you ask permission,
> >> you're just telling them to say no. Had you just put it in there chances
> >> are good it wouldn't have been flagged as "out of spec".
> >> Best Regards,
> >> Mike
> >> --
> >> Mike Starr, Writer
> >> Technical Writer - Online Help Developer - WordPress Websites
> >> Graphic Designer - Desktop Publisher - Custom Microsoft Word templates
> >> (262) 694-1028 - mike -at- writestarr -dot- com - http://www.writestarr.com
> >> President - Working Writers of Wisconsin http://www.workingwriters.org/
> >> On 6/19/2014 12:14 PM, McLauchlan, Kevin wrote:
> >> > Does everyone subscribe to the notion that customer docs should
> >> only what is necessary?
> > --
> > *Shawn Connelly*
> > Technical writer
Read about how Georgia System Operation Corporation improved teamwork, communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l