3 ms·

Importantly, learn to modulate the level of technical detail at which you describe things and establish trust with your intended audience that your level of tec

Importantly, learn to modulate the level of technical detail at which you describe things and establish trust with your intended audience that your level of technical detail matches the nature of the problem. This gives your audience a clue that when you throw around jargon, it's because there's a subtlety in the implementation detail that breaks the abstraction and they need to care about it. There's a difference between "This is a problem with our search indexing and we need to..." and "This a problem with Lucerne which is a search indexer. The tricky thing is, Lucerne implements search differently and because of that, ... and so we need to ... instead of ...".

rzzzt 5y ago
My mind immediately jumped to cows and Switzerland reading this.
greggsy 5y ago
as a security professional, there is nothing more frustrating than reading a report that completely misses the mark in terms of audience, and the overuse of industry jargon.
unfocussed_mike 5y ago
Right. You can't hide the detail with a wave of the hand, you can definitely overcommunicate detail that is unnecessary, but the art of it is finding a way to explain the bit that matters in a way that makes it clear to the users that you're eliding detail that isn't important, without misleading them. There is a very fine example of this in cinema -- the senior partners meeting in Margin Call, where Zachary Quinto's character has to explain why the firm needs to sell all of a particular asset class: https://www.youtube.com/watch?v=Hhy7JUinlu0 https://www.youtube.com/watch?v=Hhy7JUinlu0 One day I will use the line Jeremy Irons uses in this clip. I don't want to spoil it by quoting it.
- nthj 5y ago
  That’s a great scene. For anyone who hasn’t seen the movie, I might recommend skipping the clip and watching the full film! If you’re on HN, odds are you would enjoy it, and it has an impressive cast.
  - unfocussed_mike 5y ago
    It is an outstanding movie. But I think this particular scene is one of the finest scenes in any movie ever made. It could stand alone as a short.
- ColinWright 5y ago
  Outstanding film, outstanding cast, outstanding performances. I initially watched it because Stanley Tucci is in it ... I stayed for the drama, and then Jeremy Irons stole it.

rzzzt 5y ago

My mind immediately jumped to cows and Switzerland reading this.

greggsy 5y ago

as a security professional, there is nothing more frustrating than reading a report that completely misses the mark in terms of audience, and the overuse of industry jargon.

unfocussed_mike 5y ago

Right. You can't hide the detail with a wave of the hand, you can definitely overcommunicate detail that is unnecessary, but the art of it is finding a way to explain the bit that matters in a way that makes it clear to the users that you're eliding detail that isn't important, without misleading them. There is a very fine example of this in cinema -- the senior partners meeting in Margin Call, where Zachary Quinto's character has to explain why the firm needs to sell all of a particular asset class: https://www.youtube.com/watch?v=Hhy7JUinlu0 https://www.youtube.com/watch?v=Hhy7JUinlu0 One day I will use the line Jeremy Irons uses in this clip. I don't want to spoil it by quoting it.

nthj 5y ago
That’s a great scene. For anyone who hasn’t seen the movie, I might recommend skipping the clip and watching the full film! If you’re on HN, odds are you would enjoy it, and it has an impressive cast.
- unfocussed_mike 5y ago
  It is an outstanding movie. But I think this particular scene is one of the finest scenes in any movie ever made. It could stand alone as a short.
ColinWright 5y ago
Outstanding film, outstanding cast, outstanding performances. I initially watched it because Stanley Tucci is in it ... I stayed for the drama, and then Jeremy Irons stole it.