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.
One of the additions we made to our Agile tracking software (we use Jira)
was to add a "Requires change to user documentation " checkbox for epics
and stories. It certainly helps us find things we need to track.
I'm doing a session at the STC Summit on Making Agile Work for You FWIW.
Carla - I think I remember you from DDI back in the day ...
JG
On Fri, Mar 26, 2021, 8:53 AM Annette Reilly <annetterieee -at- gmail -dot- com> wrote:
> For comprehensive guidance on information development in agile teams, see
> ISO/IEC/IEEE 26515 https://ieeexplore.ieee.org/document/6170923
>
> For advice on developing an information plan, see ISO/IEC/IEEE 26511 ,
>https://ieeexplore.ieee.org/document/8584518
>
> Yes, you would need to pay for these, but compare the cost to the hours or
> weeks of staff time it would take to get up to speed on this.
>
> But I think your question is really, what epics/ stories are being
> developed
> for the product and need to be worked into the stories assigned to the
> information developer, either in parallel with the product developers, or a
> sprint or two behind their work. So your team member needs to be working
> closely with the project team during the initial planning (Sprint zero).
>
> That is quite a sizable body of work for one person. Is that typical for
> your team? Do you have content management to reuse material (embedding
> videos in user guides for example).
>
> Good luck,
>
>
>
>
>
> -----Original Message-----
> From: Martinek, Carla <CMartinek -at- zebra -dot- com>
> Sent: Thursday, March 25, 2021 2:37 PM
> To: TechWhirl (techwr-l -at- lists -dot- techwr-l -dot- com) <techwr-l -at- lists -dot- techwr-l -dot- com>
> Subject: Agile Epics & Stories & TechPubs
>
>
>
> It's happened. We're finally getting entire projects developing through
> Agile (software has been doing it for a while, but most of what my team
> supports is hardware). In the very first project we're working with, one of
> my coworkers is expected to create Epics and Stories for a project. Known
> deliverables are 4 user guides, 2 quick start guides, 2 regulatory guides,
> and a dozen or so videos.
>
>
>
> While we've had an intro to the Agile Framework, this is one of those areas
> where it's really hard to know what to do until you've done it at least
> once. We need some handholding references on how we should proceed and
> break
> the deliverables down. Can anyone recommend some good sources to go to?
>
>
>
> Thx
>
> Carla
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
> ________________________________
>
> - CONFIDENTIAL-
>
>
>
> This email and any files transmitted with it are confidential, and may also
> be legally privileged. If you are not the intended recipient, you may not
> review, use, copy, or distribute this message. If you receive this email in
> error, please notify the sender immediately by reply email and then delete
> this email.
>
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Visit TechWhirl for the latest on content technology, content strategy and
> content development | https://techwhirl.com
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as vwritert -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 | https://techwhirl.com
