Secret ingredients to quality software


Spec - Do you effectively present the outcomes at the "Specification Review Presentation"?

Last updated by Tiago Araujo on 19 Jul 2019 01:36 am (almost 2 years ago) See History

The findings of the Spec Review should be presented by the developers and the Account Manager at a meeting with the key decision makers of the project for review and acceptance, generally in the form of a PowerPoint presentation, or sometimes a word doc. It is important that all the required people are in a room together to review the plan.

ProjectManagement DecisionMakers Small
Figure: It's a lot easier to get a signature when you've got the right people in the room

If you've run the Spec Review successfully the client should not be surprised by anything you present. This means discussions should focus on issues such as what particular requirements could be added into the scope for the MVP, or what releases can be completed by what date, rather than spending the meeting helping the client regain consciousness after they blacked out from seeing the price.

The Spec Review presentation should be scheduled by the Consultant or Account Manager for the afternoon of the final day of the Spec Review.

“I will send you a proposal when I get back to the office.”

Figure: Bad example – a common mistake is to tell the client you will complete it later

“Let’s schedule a meeting now for Wed 3 pm. I will send a meeting invite to all the stakeholders.”

Figure: Good example – this is an appointment with a specific time for the next schedule The benefits are:

  • You are striking while the iron is hot
  • All parties benefit while the information is fresh in their minds
  • The client won't experience the inevitable delays when you go back to the office and get stuck on other client issues that appear more urgent

What does the client get at the conclusion of the Spec Review?

  • Option A - Email (if they want to minimize documentation time), or
  • Option B - Word document (if they need to get approval from someone higher up), or
  • Option C - PowerPoint presentation (if they are the decision maker, and they don't want a doc)
  • Option D - Video of PowerPoint presentation with narrations exported to a video (the best option to gather more feedback, you can even gather public feedback E.g. PointBank Make sure to name your video according to the rules on How to Include Version Numbers in Your File, and add a version number to it by following the rule on How to Use a Version Number on Your Videos. Publish your video to YouTube afterwards so you can easily share it with colleagues and clients.

3 01 2014 10 13 04 PM
Figure: Good example - Export your PowerPoint presentation as a video

Video Examples

Good Example: FireBootCamp - Scrum Commitments Specification Video
Good Example: FireBootCamp - SugarLearning Specification Video

Good Example: FireBootCamp - TimePro Invoicing Specification Video

Good Example: FireBootCamp - Code Auditor Specification Video Once again, the presentation needs to pass a 'test please' from another senior employee before the meeting takes place.

Adam CoganAdam Cogan
Ulysses MaclarenUlysses Maclaren
Cameron ShawCameron Shaw
Justin KingJustin King

We open source. This page is on GitHub