Skip to main content

Tips for an Awesome Technical Demo

Since the words "Technical Demo" can be off-putting, both to the demo-giver and to any non-technical stakeholders in the audience, my teams often call them "Show-and-Tells" - they are opportunities to show progress and changes, evolutions in the system or interface, and more.

Why We Do Show-and-Tells

At the end of a Sprint, we want to pause and look back on what we accomplished, celebrate our efforts, and even to show off a little, to key people and stakeholders outside the Development group.

The Show-and-Tell time lets us do all those things. Since we do not always know what each other is doing, it is a chance to show the team. It is also a chance to show our work to the Product team, the Testers, any Support and Implementation groups, and Sales and Marketing people. It’s a great way to:

* show a finished feature

* show progress on a multi-sprint feature

* show before/after behavior of a fix

* raise questions needing input beyond tech team

The Show-and-Tell leads naturally into a discussion about the new features or fixes, with input from their perspectives about the work done so far and the next steps.

Challenges of Show-and-Tells

In a Show-and-Tell setting, we just have a few minutes of the time and attention of these other Stakeholders, so we need to be clear and to the point.

They are not technical people, but bring important other perspectives about how our work will affect our end-users. So we need to talk to them in ways that make it easier for them to put our work into their own context.

Remote presentations bring their own challenges, such as all the logistics of screen-sharing, and less feedback about audience-attention. We need to be ready for these wrinkles.

Tips for Rocking the Show-and-Tell Demo

Giving a Show-and-Tell Demo takes a set of Skills. Some people have these skills naturally, to a degree. We can all grow in our abilities and skills for demo-giving.

Tell a Story

It is tempting to dive into technical details, but the best Demo will talk about the changes from the end-user’s perspective.

* Show us how a client will use this new or changed feature

* Show the “Happy-path” first, the most common uses

* If there are important edge cases, show them next

* Do Configuration details and options need to be shown? If so, put them last

Have a Plan

You should know ahead of time what you are trying to show. Is it a finished feature? Are you showing progress and asking for guidance? Do you need to do a before-and-after of a bug fix?

* Prepare your data in advance

* Before starting, have everything you need already logged in / set up / running

* Focus the audience on what is important

* Avoid jumping out of the App - jumping away from the App they know, into a Database window or, worse,  an IDE with code, is a good way to confuse your audience

Public Speaking

A Show-and-Tell to stakeholders may be to a small group of a half-dozen, or to a larger group, 20 people  and up. If you get nervous speaking to a large group of people, you might find this unpleasant.

The usual tips for better public speaking apply:

* Prepare your talk in advance

* Practice

* Take deep breaths

* Go slow

* Repeat key points

* Enunciate your words clearly

* Posture and eye contact are a little different in remote calls, but it pays to make sure you are comfortable, and to occasionally look into the camera

* Repeat key points

Expect Feedback

Ideally we are showing fully completed work that has already been code reviewed and merged to a mainline branch. That way, QA and others can see it for themselves right away.

Even if that is the case, expect feedback. Remember:

* Feedback could be both positive and negative

* Their perspective can raise major issues from the client perspective, before they affect any clients

* They may offer small tweaks

* They may raise larger questions about the ticket’s specs or direction of the feature or app

* In-meeting feedback is not automatically a decision! The topic may need further thought and analysis by Product or Development teams

Popular posts from this blog

Git Reset in Eclipse

Using Git and the Eclipse IDE, you have a series of commits in your branch history, but need to back up to an earlier version. The Git Reset feature is a powerful tool with just a whiff of danger, and is accessible with just a couple clicks in Eclipse. In Eclipse, switch to the History view. In my example it shows a series of 3 changes, 3 separate committed versions of the Person file. After commit 6d5ef3e, the HEAD (shown), Index, and Working Directory all have the same version, Person 3.0.

Scala Collections: A Group of groupBy() Examples

Scala provides a rich Collections API. Let's look at the useful groupBy() function. What does groupBy() do? It takes a collection, assesses each item in that collection against a discriminator function, and returns a Map data structure. Each key in the returned map is a distinct result of the discriminator function, and the key's corresponding value is another collection which contains all elements of the original one that evaluate the same way against the discriminator function. So, for example, here is a collection of Strings: val sports = Seq ("baseball", "ice hockey", "football", "basketball", "110m hurdles", "field hockey") Running it through the Scala interpreter produces this output showing our value's definition: sports: Seq[String] = List(baseball, ice hockey, football, basketball, 110m hurdles, field hockey) We can group those sports names by, say, their first letter. To do so, we need a disc

Java 8: Rewrite For-loops using Stream API

Java 8 Tip: Anytime you write a Java For-loop, ask yourself if you can rewrite it with the Streams API. Now that I have moved to Java 8 in my work and home development, whenever I want to use a For-loop, I write it and then see if I can rewrite it using the Stream API. For example: I have an object called myThing, some Collection-like data structure which contains an arbitrary number of Fields. Something has happened, and I want to set all of the fields to some common state, in my case "Hidden"

How to do Git Rebase in Eclipse

This is an abbreviated version of a fuller post about Git Rebase in Eclipse. See the longer one here : One side-effect of merging Git branches is that it leaves a Merge commit. This can create a history view something like: The clutter of parallel lines shows the life spans of those local branches, and extra commits (nine in the above screen-shot, marked by the green arrows icon). Check out this extreme-case history:  http://agentdero.cachefly.net/unethicalblogger.com/images/branch_madness.jpeg Merge Commits show all the gory details of how the code base evolved. For some teams, that’s what they want or need, all the time. Others may find it unnecessarily long and cluttered. They prefer the history to tell the bigger story, and not dwell on tiny details like every trivial Merge-commit. Git Rebase offers us 2 benefits over Git Merge: First, Rebase allows us to clean up a set of local commits before pushing them to the shared, central repository. For this

Code Coverage in C#.NET Unit Tests - Setting up OpenCover

The purpose of this post is to be a brain-dump for how we set up and used OpenCover and ReportGenerator command-line tools for code coverage analysis and reporting in our projects. The documentation made some assumptions that took some digging to fully understand, so to save my (and maybe others') time and effort in the future, here are my notes. Our project, which I will call CEP for short, includes a handful of sub-projects within the same solution. They are a mix of Web APIs, ASP MVC applications and Class libraries. For Unit Tests, we chose to write them using the MSTest framework, along with the Moq mocking framework. As the various sub-projects evolved, we needed to know more about the coverage of our automated tests. What classes, methods and instructions had tests exercising them, and what ones did not? Code Coverage tools are conveniently built-in for Visual Studio 2017 Enterprise Edition, but not for our Professional Edition installations. Much less for any Commun