from user stories to live documentationscg.unibe.ch/.../2019-12-17-croxall-fromuserstories.pdf ·...
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](https://reader035.vdocuments.us/reader035/viewer/2022071113/5fea03298727d74f8210747d/html5/thumbnails/1.jpg)
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](https://reader035.vdocuments.us/reader035/viewer/2022071113/5fea03298727d74f8210747d/html5/thumbnails/2.jpg)
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](https://reader035.vdocuments.us/reader035/viewer/2022071113/5fea03298727d74f8210747d/html5/thumbnails/3.jpg)
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](https://reader035.vdocuments.us/reader035/viewer/2022071113/5fea03298727d74f8210747d/html5/thumbnails/4.jpg)
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](https://reader035.vdocuments.us/reader035/viewer/2022071113/5fea03298727d74f8210747d/html5/thumbnails/5.jpg)
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](https://reader035.vdocuments.us/reader035/viewer/2022071113/5fea03298727d74f8210747d/html5/thumbnails/6.jpg)
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](https://reader035.vdocuments.us/reader035/viewer/2022071113/5fea03298727d74f8210747d/html5/thumbnails/7.jpg)
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](https://reader035.vdocuments.us/reader035/viewer/2022071113/5fea03298727d74f8210747d/html5/thumbnails/8.jpg)
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](https://reader035.vdocuments.us/reader035/viewer/2022071113/5fea03298727d74f8210747d/html5/thumbnails/9.jpg)
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](https://reader035.vdocuments.us/reader035/viewer/2022071113/5fea03298727d74f8210747d/html5/thumbnails/10.jpg)
KEY POINTS