Documenting decisions and discoveries with Piers Sinclair

https://ssw.com.au/rules/document-dis…

Work can change quickly. So, if decisions and discoveries haven’t been documented, it can cause significant pain down the line.

For example, if a new developer takes over the Work Item, they might be confused or uninformed. Therefore, when the requirements of a Work Item change or critical information is found, these details should be accessible to everyone on the Scrum team.

0:00 | Introduction

0:22 | The problem not having an audit trail

0:52 | An example of documenting a decision

1:15 | When should you document a decision?

1:28 | Using Notepad

1:46 | Using emails

2:05 | Using Azure DevOps PBIs

2:13 | The 5 Benefits

2:25 | Check out our rule and learn more

Subscribe for more content from SSW TV

Press like and leave a comment below to let us know how we’re doing

LinkedIn ↴

https://www.linkedin.com/company/ssw/

Twitter ↴

https://twitter.com/ssw_tv

Facebook ↴

https://www.facebook.com/SSW.page

~~—————————————————————————-~~

Piers Sinclair – https://www.ssw.com.au/people/piers-s…

Piers is a Solution Architect with more than 7 years experiences in databases and software development. He is especially proficient in Scrum, .Net, Azure, SQL, DevOps and GitHub. He has been involved in many industries including Retail, Logistics and Job Management.

When it comes to developing software, Piers has a passion for efficient development processes, designing quality solutions and building robust software architecture.

He is very interested in understanding the way systems work and coming up with innovative solutions to complex problems. He speaks Chinese and has a keen interest in China. In particular, he is passionate about the successful management of Chinese IT teams and is one part of the bridge that connects SSW Australia and SSW China.

~~—————————————————————————-~~

See more videos at https://tv.ssw.com

For more information about SSW’s web application consulting services, please visit https://ssw.com.au/ssw/Consulting/Web…

Created by SSW TV | Videos for developers, by developers

v4-Andrew/Jonty

About the speakers

Piers Sinclair

Piers is a Solution Architect with more than 7 years experiences in databases and software development. He is especially proficient in Scrum, .Net, Azure, SQL, DevOps and GitHub.

He has been involved in many industries including Retail, Logistics and Job Management. When it comes to developing software, Piers has a passion for efficient development processes, designing quality solutions and building robust software architecture. He is very interested in understanding the way systems work and coming up with innovative solutions to complex problems.

He speaks Chinese and has a keen interest in China. In particular, he is passionate about the successful management of Chinese IT teams and is one part of the bridge that connects SSW Australia and SSW China.

Treat Your Code Like Uranium | Adam Cogan

Adam Cogan shares a striking story comparing two World War II factories—one ordinary, one handling uranium—and the surprising lesson that the uranium workers lived longer because they followed disciplined, risk-aware practices. He connects that idea to software teams: the best outcomes come from careful habits like automated tests, telemetry, pull requests, retrospectives, shared rules, and good tools. The message is simple: treat software delivery with the same respect as dangerous work, and you’ll reduce stress, avoid chaos, and get better results.

3 Tips for Better Video Recordings | Adam Cogan

Great coaching can dramatically improve how you present, communicate, and learn. In this video, Adam Cogan shares 3 practical coaching tips that SSW uses every day—from onboarding and role plays to improving video delivery. He explains why having a coach matters, why immediate interruption beats delayed feedback, and how repeating corrections helps lock in better habits.

TinaCMS + Fumadocs: Bring Visual Editing to Your Docs | Hark Singh

Discover how to connect Playwright with AI agents and unlock powerful workflows.

Stop Using 👍 Wrong in Teams | Adam Cogan

A quick communication tip from Adam Cogan: don’t use 👍 as a catch-all response when someone assigns you a task in Teams, Slack, or Google Chat. In the example Adam gives, if a task will take about five minutes, a thumbs up is too ambiguous because it does not clearly say whether you’ve read it, agree with it, are doing it now, or will do it later. Instead, use 👍 for agreement, 👀 to show you’ve seen the task and are actively working on it, and then replace 👀 with ✅ once the task is done. It is a small change, but it removes ambiguity and cuts down unnecessary follow-up messages.

How to record a done video in SSW | Sylvia Huang | SSW Rules

Sylvia Huang from SSW shares her SSW Cultural Exchange experience from Hangzhou, China to Australia

4 Essential Sales Tips for Engineers | Adam Cogan

Not a salesman? No problem. Adam Cogan shares 4 practical tips to help engineers navigate sales meetings with confidence. Learn how to stop “selling” and start solving, how to talk numbers without the awkwardness, and why being transparent about your process wins more clients.

Do you explain why you’ve deleted or updated an appointment? | Adam Cogan | SSW Rules

Ever wonder why a meeting was moved or cancelled? Adam Cogan explains the “Secret Ingredient” to professional scheduling: always include a version history and reason for change at the top of your appointments. Improve clarity, keep a record of changes, and hold participants accountable with this simple SSW Rule.

Chat first before changing others’ code | Adam Cogan

Changing someone else’s code? Don’t just dive in! Adam explains why it’s important to check the source history and talk to the original developer before making changes. A quick chat can save headaches and keep everyone on the same page. Perfect advice for devs working in teams!