0
Today’s agile documentation
 oday s ag e docu e tat o
Megan Leney, Senior Information Developer
Symantec Corporation
July ...
About me

                •Agile enthusiast, C tifi d S
                 A il     th i t Certified Scrum M tMaster
       ...
Agenda
 g


    1    Overview of current agile and trends

    2    The 2009 Symantec Agile Documentation Survey

    3   ...
Overview of agile and
current trends
What Agile is not…
      g



• A new idea
• A“
   “cookie cutter” solution f all problems
       ki    tt ” l ti for ll  ...
What Agile is about…
      g



• Iterative development
• H d work
  Hard   k
• Transparency




                         ...
Key agile stakeholders
  y g
• Product owner
  –C b a P d t M
   Can be Product Manager or P j t M
                       ...
Agile vocabulary
 g             y
• Scrum. A scrum is a 15-30 minute daily check-in meeting in
  which you report p g
    ...
Agile vocabulary
 g             y
• User Story. A simple story that reflects a customer
  requirement. Stories are p
    q...
Agile vocabulary
 g             y
• Task. A unit of work that can be completed in 1-2 days.
• Acceptance criteria. The cri...
Agile then and now
 g

2001 (the year Agile Manifesto signed)
     (    y     g                g   )      2009

Integratin...
Recent trends in agile and what they
mean to information developers
                           p

Agile trend
 g          ...
Big ugly problems
 Insert Photo               are solved by
    Here
                            peoples’ brains,
        ...
The 2009 Symantec
Agile Documentation
Survey
Global survey: 57 Symantec info dev
p
professionals
Agile experience
 g      p

       Years of experience



        18% more
       than 3 years

                      52% ...
(Non-agile writers) How would
switching to agile impact you?
        g     g      p    y
Percentage of non-agile writers who think
agile would help in the following areas:
 g             p                g
Percentage of non-agile writers who think
these agile practices would help
       g p                     p
To transition to agile, information
developers need to understand…
       p
Agile/scrum benefits
• S t i bl schedule
  Sus...
How helpful do agile writers find
agile?
 g
How helpful do agile writers ?
       p        g
How helpful do agile writers find
agile/scrum?
 g
How helpful do agile writers find
agile/scrum?
 g
How helpful do agile writers find
agile?
 g
How else does agile help information
developers?
      p
• Strong support for the documentation process
• A better sense o...
How helpful do agile writers find
these agile practices?
       g p
How helpful do agile writers find
these agile practices?
       g p
How helpful do agile writers find
these agile practices?
       g p
How helpful do agile writers find
these agile practices?
       g p
How helpful do agile writers find
these agile practices?
       g p
What other agile/scrum practices
help Information Developers?
   p                   p
• Detailed scheduling ensures devel...
What Symantec
information
developers are saying
d    l            i
Undergo agile training; talk to
other information developers who
work in an agile environment;
understand what agile can a...
Make an effort to integrate with
the Dev and QA processes,
instead of embedding yourself in
a defined ‘InfoDev’ process fl...
Information developers must
educate the engineering
team about how the Tech
Pubs team will work with
them in the agile met...
What the agile trends mean to writers
          g


     1   Agile and frequent deployment

     2   Increased geographic ...
Agile and frequent
deployment
What is more frequent deployment?
                q       p y
• Time boxing (small increments of work in a short time)
• D...
How has more frequent deployment
affected documentation quality?
                       q     y
Agile documentation reviews
 g
• Iterative reviews are very informal
  – Perform daily reviews, or as often as needed
    ...
One risk of agile is that focus
is shifted from ‘the forest’ to
‘the trees.’

           Anonymous survey response




   ...
How have more frequent reviews
impacted documentation quality?
  p                    q     y
How have more frequent reviews
impacted documentation quality?
  p                    q     y
How have more frequent reviews
impacted documentation quality?
  p                    q     y
How does more frequent deployment
affect ability to manage workload?
             y        g
Strategy #1 Know that the whole team
is responsible for the backlog
      p                      g

Cross-training helps t...
Strategy #2 Put everything you do on
the backlog
          g
Reasons to put everything on the backlog
• Y get credit f eve...
Strategy #3 Spend story points wisely
and communicate availability
                           y
• Think about how you want...
Strategy #4 Create a definition of
“done” that works for you
                      y
• Think about how you want to work
  ...
Increased geographic
distribution
What kind of team(s) do you work
with?
How much do you gain agile benefits
working with remote teams?
      g
How much do you gain agile benefits
working with remote teams?
      g
How much do you gain agile benefits
working with remote teams?
      g
How much do you gain agile benefits
working with remote teams?
      g
How much do you gain agile benefits
working with remote teams?
      g
How often do remote SMEs communicate
about incidents, issues, and features?
               ,       ,
Strategy #1 Get to know your
distributed teammates
• Team members are not roles, they are people
• R
  Respect their ti
  ...
Strategy #1 Get to know your
distributed teammates
Ask if they’d be willing to share photographs




China development tea...
Strategy #1 Get to know your
distributed teammates
Responses from teammates about exchanging photographs:
Hey Willi
H   Wi...
Form a good working relationship,
and maintain it by being
accessible and responsive.
            Anonymous survey respons...
Do your homework and target
…questions and requests…to the
most appropriate person - respect
their time.

             Ano...
My t
M team mates are not as
              t        t
young today as when we
started working together so
 t t d       ki t...
Strategy #2 Tailor stories to the way
y
your organization works
       g
Two schools of thought:
1.Make the t i
1 M k th s...
Strategy #3 Use technology
      gy                gy
• Share your desktop using Live Meeting and co-develop
  content wit...
Strategy #4 Be p
      gy       persistent
• Find out who you need to talk to
• C ll and i t t message often
  Call d inst...
How effectively do remote SMEs
communicate important information?
                 p
Communicate as often as
p
possible.
         Anonymous survey response




                                     71
Accountability and
transparency
Information Developers
…(need) to estimate…to the
  (     )
feature level -- and when
working on multiple features,
      ...
The (scrum) process it lf
Th (       )          itself
provides all of the accountability
and transparency anyone could
  ...
Advantages of accountability and
transparency
     p     y
• Understanding documentation tasks
• S l i i
  Solving issues ...
Agile…makes it easier to
A il      k       i t
understand when schedules
might be at risk.
 i ht b t i k
           Anonym...
How well do you understand your
documentation tasks?
How much motivation does the daily
reporting of status give you to complete
stories?
How often do you experience team
 swarm?



Team “swarm”
is energetically
working with
scrum
teammates to
complete
stories...
(
(What) seems to enhance
       )
"accountability & transparency"
is when I complete a more
                p
challenging...
Communicate expectations.
C        i             i
…Don't agree to something
before you investigate, that
b f        i    ...
Leveraging customer
relationships
Why work closely with product
management?
    g
• Product managers are the voice of the customer
• P d t managers are good...
How easy is it to create documentation that
meets customers’ needs?
How easy is it to adapt to customers’
changing requirements?
    g g q
How well does your product owner convey
changes in customer requirements?
    g                 q
The agile model comes with
built-in flexibility...If a feature
                   y
is urgently required by a
customer…(yo...
The more contact with field
personnel who directly deal
with customers and with
     customers,
customers themselves, the
...
Add value to not just the
documentation but the
product as a whole.

              Anonymous survey response




         ...
Q&A
Summary and
S           d
Conclusions
Delivering quality with more frequent
deployment
  p y
• Work closely with the team to get information
• H ld reviews ofte...
Communicating with remote team
members
• Get to know your teammates
• A k questions, rather th expecting them t communicat...
Using accountability and
transparency to your advantage
     p     y    y           g
• Make it a priority to attend all s...
Leveraging close relationships with
customers
• Work closely with the product owner to understand customer
  needs
• Let t...
Thank Y !
                                               Th k You!

Megan Leney
  g _     y@ y
megan_leney@symantec.com


...
Today’s Agile Documentation
Today’s Agile Documentation
Upcoming SlideShare
Loading in...5
×

Today’s Agile Documentation

2,046

Published on

National Society for Technical Communication (STC) web seminar presented in July, 2009. Presents a 2009 survey of over 50 information developers at Symantec. Gives an overview of recent trends in Agile documentation. Provides tips on documenting with more frequent deployment, working with distributed teams, increased accountability and transparency, and leveraging customer relationships.

Published in: Technology, Business
1 Comment
2 Likes
Statistics
Notes
  • Megan, this was great. Thanks for posting it. I learned so much.
       Reply 
    Are you sure you want to  Yes  No
    Your message goes here
No Downloads
Views
Total Views
2,046
On Slideshare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
103
Comments
1
Likes
2
Embeds 0
No embeds

No notes for slide

Transcript of "Today’s Agile Documentation"

  1. 1. Today’s agile documentation oday s ag e docu e tat o Megan Leney, Senior Information Developer Symantec Corporation July 22, 2009
  2. 2. About me •Agile enthusiast, C tifi d S A il th i t Certified Scrum M tMaster •Sr. Information Developer, Symantec Insert Photo •Previously worked for VeriSign and Apple Here •Lead the integration of VeriSign's documentation team into the developer-run agile scrum process process. •Presented on agile documentation at 2008 LavaCon Prof. Development Conference •Member, Sili M b Silicon V ll STC Ch t Valley Chapter
  3. 3. Agenda g 1 Overview of current agile and trends 2 The 2009 Symantec Agile Documentation Survey 3 What Symantec information developers are saying 4 What the agile trends mean to writers
  4. 4. Overview of agile and current trends
  5. 5. What Agile is not… g • A new idea • A“ “cookie cutter” solution f all problems ki tt ” l ti for ll bl • A detailed plan for every contingency 5
  6. 6. What Agile is about… g • Iterative development • H d work Hard k • Transparency 6
  7. 7. Key agile stakeholders y g • Product owner –C b a P d t M Can be Product Manager or P j t M Project Manager – Figures out the WHAT with customers – Decides what comes off the backlog to get something else done • Scrum master – Often a Dev manager – Works with the team to figure out HOW things g done g g get • Team – Self-organized g – Creates value 7
  8. 8. Agile vocabulary g y • Scrum. A scrum is a 15-30 minute daily check-in meeting in which you report p g y p progress and any blocking issues. y g • Sprint (or Iteration). An iterative development cycle. The length of the cycle is predetermined by the team (usually 2-4 weeks). D i each sprint, th t k ) During h i t the team produces a d demonstrative unit. • Handoff meeting A meeting at the end of an iteration during meeting. which the team demonstrates a unit of work to the product owner. • Retrospective. A meeting during which the team reflects on what went well during the current iteration, and what they can improve on next iteration. Usually takes place right after the handoff meeting. 8
  9. 9. Agile vocabulary g y • User Story. A simple story that reflects a customer requirement. Stories are p q placed on the backlog and g prioritized during the sprint planning phase. User story format: As a <role> I want <something> (optional) so th t <some justification> that j tifi ti Some examples include: – A an IT administrator, I want i As d i i instructions on upgrading f i di from version i A to version B. – As a CTO, I want to protect my servers in case of a natural disaster, such as a flood or earthquake. 9
  10. 10. Agile vocabulary g y • Task. A unit of work that can be completed in 1-2 days. • Acceptance criteria. The criteria that determine whether a criteria story is complete. 10
  11. 11. Agile then and now g 2001 (the year Agile Manifesto signed) ( y g g ) 2009 Integrating agile team practices Deploying agile to the enterprise Product owner committed to team/responsible Product owner not too involved in process for ROI Scrum master is in charge of the team Scrum master coaches and facilitates self (command and control) organization Teams develop products for customers Teams partner with customers to create value Individual “superheroes” I di id l “ h ” Teamwork T k
  12. 12. Recent trends in agile and what they mean to information developers p Agile trend g Information development challenge p g More frequent deployment of increasingly • Managing our workload complex products • Delivering quality documentation • Getting the information we need Increased geographic distribution • Communicating remotely Increased accountability and transparency • Exposing issues so they are easier to solve • Getting what we need from product Closer relationships with customers management • Creating a better user experience
  13. 13. Big ugly problems Insert Photo are solved by Here peoples’ brains, not processes. You Dr. Dan Rawsthorne, Danube Technologies, Inc. don t don’t need big processes.
  14. 14. The 2009 Symantec Agile Documentation Survey
  15. 15. Global survey: 57 Symantec info dev p professionals
  16. 16. Agile experience g p Years of experience 18% more than 3 years 52% less than one year 30% 1-3 years
  17. 17. (Non-agile writers) How would switching to agile impact you? g g p y
  18. 18. Percentage of non-agile writers who think agile would help in the following areas: g p g
  19. 19. Percentage of non-agile writers who think these agile practices would help g p p
  20. 20. To transition to agile, information developers need to understand… p Agile/scrum benefits • S t i bl schedule Sustainable h d l • Delivering documentation value Agile/scrum practices • I Importance of daily scrum meetings t f d il ti • Continuous improvement (retrospectives) • Handoff demos each iteration 22
  21. 21. How helpful do agile writers find agile? g
  22. 22. How helpful do agile writers ? p g
  23. 23. How helpful do agile writers find agile/scrum? g
  24. 24. How helpful do agile writers find agile/scrum? g
  25. 25. How helpful do agile writers find agile? g
  26. 26. How else does agile help information developers? p • Strong support for the documentation process • A better sense of your due dates • Focus on a few features and cover them more in depth • F l lik you’re part of th team, more in th l Feel like ’ t f the t i the loop • Higher visibility • E i t set expectations Easier to t t ti 28
  27. 27. How helpful do agile writers find these agile practices? g p
  28. 28. How helpful do agile writers find these agile practices? g p
  29. 29. How helpful do agile writers find these agile practices? g p
  30. 30. How helpful do agile writers find these agile practices? g p
  31. 31. How helpful do agile writers find these agile practices? g p
  32. 32. What other agile/scrum practices help Information Developers? p p • Detailed scheduling ensures developers don’t take on too much • Using the same tools as developers to track progress • Estimating documentation tasks 34
  33. 33. What Symantec information developers are saying d l i
  34. 34. Undergo agile training; talk to other information developers who work in an agile environment; understand what agile can and cannot do for information developers. Anonymous survey response 36
  35. 35. Make an effort to integrate with the Dev and QA processes, instead of embedding yourself in a defined ‘InfoDev’ process flow. Be flexible and adaptable. Anonymous survey response 37
  36. 36. Information developers must educate the engineering team about how the Tech Pubs team will work with them in the agile method. method Anonymous survey response 38
  37. 37. What the agile trends mean to writers g 1 Agile and frequent deployment 2 Increased geographic distribution 3 Accountability and transparency 4 Leveraging customer relationships
  38. 38. Agile and frequent deployment
  39. 39. What is more frequent deployment? q p y • Time boxing (small increments of work in a short time) • D il meetings where you agree on t d ’ reality Daily ti h today’s lit • Iterations create demonstrative units –N l No longer “ t ti ll ship-able” “potentially hi bl ” – Demonstrative does not mean “sell-able” – You need at least one additional iteration to ship the p p product 41
  40. 40. How has more frequent deployment affected documentation quality? q y
  41. 41. Agile documentation reviews g • Iterative reviews are very informal – Perform daily reviews, or as often as needed reviews – Target one SME to review the text – Send as little as one paragraph p g p – Expect immediate turnaround - one day max! • Formal reviews – Hold at least one end-to-end review – Create a documentation review story • Add t k f developers and QA t review th d tasks for d l d to i the documentation t ti • Add tasks for incorporating comments 43
  42. 42. One risk of agile is that focus is shifted from ‘the forest’ to ‘the trees.’ Anonymous survey response 44
  43. 43. How have more frequent reviews impacted documentation quality? p q y
  44. 44. How have more frequent reviews impacted documentation quality? p q y
  45. 45. How have more frequent reviews impacted documentation quality? p q y
  46. 46. How does more frequent deployment affect ability to manage workload? y g
  47. 47. Strategy #1 Know that the whole team is responsible for the backlog p g Cross-training helps team members be more efficient For example, train your developers in writing error messages They make a first pass, reduce the time it takes you to write from scratch 49
  48. 48. Strategy #2 Put everything you do on the backlog g Reasons to put everything on the backlog • Y get credit f everything you d You t dit for thi do • The team sees what is left out of the build • It’ easier t plan th next ti It’s i to l the t time around d 50
  49. 49. Strategy #3 Spend story points wisely and communicate availability y • Think about how you want to spend your story points – Spend 1/3 of your points on documentation only stories documentation-only – Spend 2/3 on features • Estimate how long you spend in team meetings and training activities – These are important activities that make you more efficient – Deduct meeting and training time from resource availability 51
  50. 50. Strategy #4 Create a definition of “done” that works for you y • Think about how you want to work – Complete feature docs in the same iteration? – Complete rough drafts in the same iteration? – Deliver draft documentation in an iteration + 1 schedule? – Deliver polished chapters in an iteration +2 schedule? • Communicate what you need to accomplish the acceptance criteria – Instant reviews – Features complete the first week of iteration • Set expectations on exactly what you can deliver • No scope creep: once you’ve defined “done ” stick with it! you ve done, 52
  51. 51. Increased geographic distribution
  52. 52. What kind of team(s) do you work with?
  53. 53. How much do you gain agile benefits working with remote teams? g
  54. 54. How much do you gain agile benefits working with remote teams? g
  55. 55. How much do you gain agile benefits working with remote teams? g
  56. 56. How much do you gain agile benefits working with remote teams? g
  57. 57. How much do you gain agile benefits working with remote teams? g
  58. 58. How often do remote SMEs communicate about incidents, issues, and features? , ,
  59. 59. Strategy #1 Get to know your distributed teammates • Team members are not roles, they are people • R Respect their ti t th i time, b t ask th but k them questions about th ti b t themselves l – Get on calls early and talk while waiting for people to join – Start off talking about their career and the company 61
  60. 60. Strategy #1 Get to know your distributed teammates Ask if they’d be willing to share photographs China development team Mountain View Installer doc team Andy Wang; Fred Wen; Megan Leney and Elizabeth Carlassare Sophie Yin and William Li 62
  61. 61. Strategy #1 Get to know your distributed teammates Responses from teammates about exchanging photographs: Hey Willi H William, This is awesome! It’s always good to know your fellow members by face especially when we are working in scrum :) Hi Elizabeth/Megan, Pretty cool! Thanks for sharing this picture to us. It is very nice to see you, so vivid! And I am sure we can think of you clearer during the next conf call. g 63
  62. 62. Form a good working relationship, and maintain it by being accessible and responsive. Anonymous survey response 64
  63. 63. Do your homework and target …questions and requests…to the most appropriate person - respect their time. Anonymous survey response 65
  64. 64. My t M team mates are not as t t young today as when we started working together so t t d ki t th calls at 3 AM are no longer appreciated. i t d Anonymous survey response 66
  65. 65. Strategy #2 Tailor stories to the way y your organization works g Two schools of thought: 1.Make the t i 1 M k th stories self-contained so th t teams can lf t i d that t accomplish the story tasks independently of each other. 2.Force 2 Force the story to go across teams so that they have to talk to each other 67
  66. 66. Strategy #3 Use technology gy gy • Share your desktop using Live Meeting and co-develop content with a remote SME • Be sure the same servers and systems are available to all team members • Use Instant messenger • Some teams have the luxury of web cams, Halo conference rooms 68
  67. 67. Strategy #4 Be p gy persistent • Find out who you need to talk to • C ll and i t t message often Call d instant ft • Ask a lot of questions 69
  68. 68. How effectively do remote SMEs communicate important information? p
  69. 69. Communicate as often as p possible. Anonymous survey response 71
  70. 70. Accountability and transparency
  71. 71. Information Developers …(need) to estimate…to the ( ) feature level -- and when working on multiple features, g p , things can get ‘off schedule’ very q y quickly. y Anonymous survey response 73
  72. 72. The (scrum) process it lf Th ( ) itself provides all of the accountability and transparency anyone could dt ld possibly want. Anonymous survey response y y p 74
  73. 73. Advantages of accountability and transparency p y • Understanding documentation tasks • S l i i Solving issues b f before th get out of hand they t t f h d • The whole team is responsible for user stories • I Increased motivation to complete stories d ti ti t l t t i – For developers—they’re forced to complete reviews on time – For writers—keeps us on track easier to meet deadlines writers keeps track, 75
  74. 74. Agile…makes it easier to A il k i t understand when schedules might be at risk. i ht b t i k Anonymous survey response 76
  75. 75. How well do you understand your documentation tasks?
  76. 76. How much motivation does the daily reporting of status give you to complete stories?
  77. 77. How often do you experience team swarm? Team “swarm” is energetically working with scrum teammates to complete stories Bee images from: Winterville Elementary School Media Center http://wintervillemc.googlepages.com/home
  78. 78. ( (What) seems to enhance ) "accountability & transparency" is when I complete a more p challenging piece, I PDF it and send it to concerned parties to p see if … (it’s) in the ballpark with p their expectations. Anonymous survey response 80
  79. 79. Communicate expectations. C i i …Don't agree to something before you investigate, that b f i ti t th t way you can always complete things you commit to do. thi it t d Anonymous survey response 81
  80. 80. Leveraging customer relationships
  81. 81. Why work closely with product management? g • Product managers are the voice of the customer • P d t managers are good at b ildi customer Product d t building t relationships • Customers deserve to know what you are doing; they are paying for it 83
  82. 82. How easy is it to create documentation that meets customers’ needs?
  83. 83. How easy is it to adapt to customers’ changing requirements? g g q
  84. 84. How well does your product owner convey changes in customer requirements? g q
  85. 85. The agile model comes with built-in flexibility...If a feature y is urgently required by a customer…(you) factor it (y ) into the (iteration) planning. Anonymous survey response 87
  86. 86. The more contact with field personnel who directly deal with customers and with customers, customers themselves, the better. better You need to understand your audience. Anonymous survey response 88
  87. 87. Add value to not just the documentation but the product as a whole. Anonymous survey response 89
  88. 88. Q&A
  89. 89. Summary and S d Conclusions
  90. 90. Delivering quality with more frequent deployment p y • Work closely with the team to get information • H ld reviews often; send d Hold i ft d documentation t j t a f t ti to just few t team members • Put all tasks for formal reviews on the backlog 92
  91. 91. Communicating with remote team members • Get to know your teammates • A k questions, rather th expecting them t communicate Ask ti th than ti th to i t information • Use technology to facilitate meetings and the exchange of information 93
  92. 92. Using accountability and transparency to your advantage p y y g • Make it a priority to attend all scrum meetings • W k energetically (“ Work ti ll (“swarm”) with t ”) ith teammates to complete t t l t stories • Set expectations so the team knows what you can commit to expectations, 94
  93. 93. Leveraging close relationships with customers • Work closely with the product owner to understand customer needs • Let the product owner know what you need from them to deliver value 95
  94. 94. Thank Y ! Th k You! Megan Leney g _ y@ y megan_leney@symantec.com Copyright © 2008 Symantec Corporation. All rights reserved. Symantec and the Symantec Logo are trademarks or registered trademarks of Symantec Corporation or its affiliates in the U.S. and other countries. Other names may be trademarks of their respective owners. This document is provided for informational purposes only and is not intended as advertising. All warranties relating to the information in this document, either express or implied, are disclaimed to the maximum extent allowed by law. The information in this document is subject to change without notice.
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×