Agile, Jira tickets, and document planning

Subject: Agile, Jira tickets, and document planning
From: Stuart Conner <stuart2 -at- stuartconner -dot- me -dot- uk>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 3 Apr 2018 20:01:41 +0100

I'm in a new job where I need to plan and produce some documentation in an
Agile environment.

I have a known number of documents to produce within the next 3 months, with
each sprint being 2 weeks long. The order in which the documents are
produced is not critical.

Each document will require the following sequence of activities: (1) A
developer SME either writes an initial draft of the document or conveys that
information to me verbally, (2) I produce a good draft of the document,
gathering further information from the SME as needed, (3) review, further
rework and eventually sign-off. All the usual stuff.

The main pain-point is going to be getting developer time to work on the
documentation, as they have code to develop as well. We'll raise a Jira
ticket for each document so the necessary time can be planned into each

My question relates to the best way to track things in Jira:

(1) We could say that for each sprint, the developer and I will work on
documents A, B and C, and we raise Jira tickets for these. But doing this,
developer time will be needed early in the sprint if he/she is to do their
part leaving enough time for me to rework and finish the draft before the
end of the sprint. If the developer gets tied up with other stuff during the
first week of the sprint and can't look at the documentation until the
second week, then I won't have time to complete the documents before the end
of the sprint.

(2) We could separate the developer's time on the documents from my time. So
for each sprint, the developer will work on initial drafts for documents A,
B and C, and I work on the drafts the developer produced in the last sprint.
More flexible, more likely to finish the work scheduled for each sprint, but
double the number of Jira tickets to be tracked.

(3) We could say that for each sprint, the developer will work on documents
A, B and C, but I will work 'outside' the sprints, being flexible on how I
work on the drafts produced by the developer. I track my progress on the
documents separately. We don't drown in Jira tickets. But to some extent I'm
working outside the Agile team.

Anyone been in a similar situation and have any advice on what worked for



Visit TechWhirl for the latest on content technology, content strategy and content development |


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 for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @


Previous by Author: Re: Documentation titles
Next by Author: RE: Alternatives to swagger-codegen?
Previous by Thread: Re: "layouting," ugh.
Next by Thread: Re: Agile, Jira tickets, and document planning

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

Sponsored Ads