15
Copyright © 2013, SAS Institute Inc. All rights reserved. DOCUMENTATION THRIVES IN AN AGILE METHODOLOGY BY JENNA MOORE, ASSOCIATE FELLOW SENIOR TECHNICAL WRITER, SAS INSTITUTE

Documentation thrives in an agile methodology

Embed Size (px)

DESCRIPTION

This presentation shows agile newbies how to successfully incorporate accurate and complete documentation into the agile process.

Citation preview

Page 1: Documentation thrives in an agile methodology

Copy r ight © 2013, SAS Ins t i tu te Inc . A l l r ights reserved.

DOCUMENTATION THRIVES IN AN AGILE METHODOLOGY

BY JENNA MOORE, ASSOCIATE FELLOWSENIOR TECHNICAL WRITER, SAS INSTITUTE

Page 2: Documentation thrives in an agile methodology

Copy r ight © 2013, SAS Ins t i tu te Inc . A l l r ights reserved.

AGENDA

• Who should be here• Define the issues• Review the options• Review Agile development• Fit the doc into the agile cycle• Learn the benefits• Learn to implement it fully

Page 3: Documentation thrives in an agile methodology

Copy r ight © 2013, SAS Ins t i tu te Inc . A l l r ights reserved.

TRADITIONAL PROJECT WATERFALL Documentation work traditionally falls here

Page 4: Documentation thrives in an agile methodology

Copy r ight © 2013, SAS Ins t i tu te Inc . A l l r ights reserved.

LAST MINUTEOUT OF TIME!

Page 5: Documentation thrives in an agile methodology

Copy r ight © 2013, SAS Ins t i tu te Inc . A l l r ights reserved.

WHAT IS AGILE? TERMINOLOGY

Story, User Story: is a software system requirement. Usually they are short and consists of several sentences.

Iteration: is a time period (2 weeks to 2 months) in which the team implements and delivers a set of functionality (user stories).

Scrum, or Stand Up: is a status check where the team meets and share progress, impediments and short term assignments. Usually three questions asked: "What did you do yesterday?", "What will you do today?" and "What is blocking progress?"

Backlog: is a list of user stories, bugs, and features that need to be completed.

Theme: is a collection of user stories.

Page 6: Documentation thrives in an agile methodology

Copy r ight © 2013, SAS Ins t i tu te Inc . A l l r ights reserved.

HOW DO THEY FIT?

Page 7: Documentation thrives in an agile methodology

Copy r ight © 2013, SAS Ins t i tu te Inc . A l l r ights reserved.

BENEFIT 1 JUST IN TIME DOCUMENTATION

• Write it during the dev

story• Technical review while

fresh• Saves time later

Page 8: Documentation thrives in an agile methodology

Copy r ight © 2013, SAS Ins t i tu te Inc . A l l r ights reserved.

BENEFIT 2 HIGHER ACCURACY

• Review during story• Functionality and

intent are fresh

Page 9: Documentation thrives in an agile methodology

Copy r ight © 2013, SAS Ins t i tu te Inc . A l l r ights reserved.

BENEFIT 3BETTER SCHEDULE MANAGEMENT FOR DOC AND DEV TEAMS

• Doc and dev in sync• Editors involved earlier• Long end-cycle

processes are shortened

or eliminated

Page 10: Documentation thrives in an agile methodology

Copy r ight © 2013, SAS Ins t i tu te Inc . A l l r ights reserved.

IMPLEMENTATION 1 SCRUMS

Attend daily or

weekly scrums

Page 11: Documentation thrives in an agile methodology

Copy r ight © 2013, SAS Ins t i tu te Inc . A l l r ights reserved.

IMPLEMENTATION 2 ITERATION BACKLOG

Add

documentation to

the iteration

backlog

Page 12: Documentation thrives in an agile methodology

Copy r ight © 2013, SAS Ins t i tu te Inc . A l l r ights reserved.

IMPLEMENTATION 3 PRODUCT BACKLOG

Add documentation only steps to the product backlog or appropriate

iteration.• Technical Review• Edit• Production steps

Final

documentation

steps

Page 13: Documentation thrives in an agile methodology

Copy r ight © 2013, SAS Ins t i tu te Inc . A l l r ights reserved.

REVIEW

Getting Started

• Release planning meetings• Get your stories into the backlog• Decide with development how to

pursue the documentation-

concurrent, one iteration back, or

other

Keeping Up

• Assign ownership of documentation

stories• Attend daily or weekly scrums• Improve processes as you go

Page 14: Documentation thrives in an agile methodology

Copy r ight © 2013, SAS Ins t i tu te Inc . A l l r ights reserved.

Q&A

Page 15: Documentation thrives in an agile methodology

Copy r ight © 2013, SAS Ins t i tu te Inc . A l l r ights reserved.

JENNA MOORE ASSOCIATE FELLOW

Slideshare.net: jcpmooreLinkedIn: www.linkedin.com/in/techwriting