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
> current
> > Jira configuration doesn't really meet my documentation workflow
> > requirements. Additionally, I have found very little about this subject
> on
> > 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
> than
> >> 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,
> task...).
> >>
> >> 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
> aren't
> >> assigned to any sprint, that aren't supposed to be implemented unless
> I've
> >> 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
> for
> >> 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
> places
> >> along that spectrum; if I had rhythm, you could call what I do
> "dancing"...
> >> 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
> only
> >> 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
> contain
> >> only what is necessary?
> >>
> >
> > --
> > *Shawn Connelly*
> > Technical writer
> >
>

--
*Shawn Connelly*
Technical writer

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Read about how Georgia System Operation Corporation improved teamwork, communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l

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

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:
Using jira for documentation development workflows: From: Shawn
Re: Using jira for documentation development workflows: From: Robert Lauriston

Previous by Author: Re: OT: Criticizing your significant other
Next by Author: Re: Can style trump grammar rules?
Previous by Thread: RE: Using jira for documentation development workflows
Next by Thread: Re: Using jira for documentation development workflows


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

Sponsored Ads


Sponsored Ads