Holy cow, I wrote a book!
Some years ago,
I attended a internal presentation where one group
was teaching another group how to use their new feature.
This particular feature was a "Just plug in the things you want,
click the Apply button,
and sit back and relax while we figure out how to do what you asked"
type of feature.
The presentation leader showed some examples of the feature in action,
and gave some clear, concise guidance on how the feature
should be used,
"Use Pattern A when the user is faced with a choice
between two clear options,
but use Pattern B when the situation is more open-ended."
So far so good.
The next part of the presentation was given to the feature's
The lead designer called out some design principles that
the feature adhered to.
"Notice that we always position the Widget above the Frob."
But then the lead designer started getting into details that
were basically a fifteen-minute way of saying,
"Look how hard our job is."
The designer called up the graphic design software,
showing off the bazillion buttons and sliders and switches
that the designers used to fine-tune the colors,
gradients, and shading.
The designer then went through the animation storyboard templates
and showed how each of the carefully-plotted curves
achieves the desired visual effect.
Once we reached the "Look how hard our job is" portion,
the presentation ground to a halt.
The lead designer lost sight of the fact that all this information
about how hard the feature was to design was not
The attendees did not need this information in order to use the feature
It was just showing off for the sake of showing off,
and it basically wasted everybody's time.