This slide-pack describes a prototype application for building contextual documentation from Agile stories. The impact on normal Story writing is minimal, a set of business-related tags form the first line of the Story description.
2. Agile Documentation – Bringing it All Together
• Agile project -> stories
• Stories contain
• Description of tasks
• The version of applicable codebase
• New piece:
• Story first line is Tag words collection:
• E.g. (Tags: Design Request, ERET, iPhone, Production, Defect, V12.8)
• Et Sensus prototype app collects the Tags in stories and displays
them as a Tag Cloud -> click on Tag and see the set of related stories
- the “documentation” referencing the Tag
(c) 2017 D. Harrison All Rights Reserved [www.dharrisonch.com, dharrison_ch@yahoo.co.uk]
3. Agile Documentation – Bringing it All Together
(c) 2017 D. Harrison All Rights Reserved [www.dharrisonch.com, dharrison_ch@yahoo.co.uk]
• Clicking on the «Andoid» Tag, we see, for example
4. (c) 2017 D. Harrison All Rights Reserved [www.dharrisonch.com, dharrison_ch@yahoo.co.uk]
Agile Documentation – Bringing it All Together
• Prototype
• scans test data in folders to build Tag Cloud
• Final version
• will use REST/JSON API of Atlassian tool – Sprint, Epic etc and build up the Tag
Cloud
• will allow entries in the repository to be opened directly (separate Tab
Page(s)) from the Story list
5. (c) 2017 D. Harrison All Rights Reserved [www.dharrisonch.com, dharrison_ch@yahoo.co.uk]
Agile Documentation – Bringing it All Together
• Benefits
• Allows story descriptive content to be brought together in a consistent way
• Linkage allows all the stories associated with a specific Business Word Tag to
be viewed
• Provide for a more contextual discussion with Stakeholders at Demo r Review
meetings