from user stories to live documentationscg.unibe.ch/.../2019-12-17-croxall-fromuserstories.pdf ·...

10
FROM USER STORIES TO LIVE DOCUMENTATION EMILY CROXALL SOFTWARE COMPOSITION SEMINAR FALL 2019

Upload: others

Post on 07-Sep-2020

1 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: FROM USER STORIES TO LIVE DOCUMENTATIONscg.unibe.ch/.../2019-12-17-Croxall-FromUserStories.pdf · 2019. 12. 17. · DOCUMENTATION ON AN IDE • How to model projects on an IDE using

FROM USER STORIES TO LIVE DOCUMENTATION

EMILY CROXALL SOFTWARE COMPOSITION SEMINAR

FALL 2019

Page 2: FROM USER STORIES TO LIVE DOCUMENTATIONscg.unibe.ch/.../2019-12-17-Croxall-FromUserStories.pdf · 2019. 12. 17. · DOCUMENTATION ON AN IDE • How to model projects on an IDE using

DOCUMENTATION ON AN IDE

• How to model projects on an IDE using an Agile Framework and combine all project elements on one medium

• Displaying requirements near or next to code

• Benefiting developers, stakeholders, and product owners

• Work to model epics, use cases, user stories, scenarios, source code, and test cases

Page 3: FROM USER STORIES TO LIVE DOCUMENTATIONscg.unibe.ch/.../2019-12-17-Croxall-FromUserStories.pdf · 2019. 12. 17. · DOCUMENTATION ON AN IDE • How to model projects on an IDE using

EPICS

• Umbrella containing use cases, user stories, and scenarios

• Focus on one feature that needs to be developed

Page 4: FROM USER STORIES TO LIVE DOCUMENTATIONscg.unibe.ch/.../2019-12-17-Croxall-FromUserStories.pdf · 2019. 12. 17. · DOCUMENTATION ON AN IDE • How to model projects on an IDE using

USE CASE

• Define how a user and the system work together to complete a task

• General workflow for a user

Page 5: FROM USER STORIES TO LIVE DOCUMENTATIONscg.unibe.ch/.../2019-12-17-Croxall-FromUserStories.pdf · 2019. 12. 17. · DOCUMENTATION ON AN IDE • How to model projects on an IDE using

USER STORIES

• Basic structure

As a <user>, I want to <action> so that <goal>

• Individual action that can be implemented and tested in a small amount of time

• Contains specific scenarios that act as test cases

Page 6: FROM USER STORIES TO LIVE DOCUMENTATIONscg.unibe.ch/.../2019-12-17-Croxall-FromUserStories.pdf · 2019. 12. 17. · DOCUMENTATION ON AN IDE • How to model projects on an IDE using

WHY PHARO?

• Integration of code with interactive user interface

• Customizable views

• Testing technical feasibility for future work

Page 7: FROM USER STORIES TO LIVE DOCUMENTATIONscg.unibe.ch/.../2019-12-17-Croxall-FromUserStories.pdf · 2019. 12. 17. · DOCUMENTATION ON AN IDE • How to model projects on an IDE using

DEMO

Page 8: FROM USER STORIES TO LIVE DOCUMENTATIONscg.unibe.ch/.../2019-12-17-Croxall-FromUserStories.pdf · 2019. 12. 17. · DOCUMENTATION ON AN IDE • How to model projects on an IDE using

CHALLENGES

• Unfamiliarity with SmallTalk and Pharo

• Finding views to suit all contributors

• Deciding on hierarchy of agile structure

Page 9: FROM USER STORIES TO LIVE DOCUMENTATIONscg.unibe.ch/.../2019-12-17-Croxall-FromUserStories.pdf · 2019. 12. 17. · DOCUMENTATION ON AN IDE • How to model projects on an IDE using

FUTURE WORK

• Improve actor class

• Include more visually representative views

• Test ease of use for non technical contributors

Page 10: FROM USER STORIES TO LIVE DOCUMENTATIONscg.unibe.ch/.../2019-12-17-Croxall-FromUserStories.pdf · 2019. 12. 17. · DOCUMENTATION ON AN IDE • How to model projects on an IDE using

KEY POINTS