Importance of communication and how to improve it

In summary, the code in question implements an algorithm to calculate uncertainties in a linear fit of data.
  • #1
Grelbr42
68
125
So the generic question here is, how to improve communication?

Recently I started a review task for a coworker's analysis. One of the items in the report for the analysis is a graph with a linear fit of some data. And the linear fit has uncertainty reported in the fitting parameters. So I ask "What did you do to produce these uncertainties?" His response is "I calculated them." Um... Click click click. "Yes, but what did you *do*?" So he starts to show me his PERL script. "Wait. OK. What does the PERL script do?" He tries to show me more script. "No no. Source code is not documentation." He looks quite upset with me but pauses. "What does the script do to calculate the uncertainties?" Suddenly he's back in the groove, walking me through 200 lines of PERL. And suddenly I see that he has included a covariance matrix. Sigh. I know what the client will do with *that*. They have a very large pile of such things behind their facility. On the far side of the parking lot behind the trees. "So you used the textbook formulas, fed the data in, and got reports of the uncertainty of the fitting parameters, yes?" Well... Yes. But my PERL script... "No no, that's quite alright. I have what I needed."

How could I have asked this question so that my meaning got through?
 
Physics news on Phys.org
  • #2
If this is the first interaction of this sort, then I think it is natural to have some iteration on questions to get to the heart of the matter. I suppose in this instance you could have asked what type of uncertainty or equations are implemented by the code. You kept asking what he did, and he definitely wrote code. You also asked what does the script do. These are all easily interpreted to require answer that talk about the script.
 
  • #3
Grelbr42 said:
"No no. Source code is not documentation."
Was the code commented? Was there a good summary of the code in the comments at the top of the file?
 
  • #4
Grelbr42 said:
How could I have asked this question so that my meaning got through?
Be careful. You could find yourself with the added responsibility of supervising this person. Extra work, much frustration, and at the same pay.

Some suggestions:

What is the algorithm implemented in your code?

Sketch the flow chart of the your code.

Sketch the flow chart of the algorithm in your code. Yes. Now. Freehand.
 
  • Like
Likes berkeman
  • #5
berkeman said:
Was the code commented? Was there a good summary of the code in the comments at the top of the file?
No comments whatever. Variable names like xj and yq.
 
  • Wow
Likes berkeman
  • #6
How could I have asked this question so that my meaning got through?

"What underlying methodology did you use to base your calculations on?"
 
  • Like
Likes Hornbein

Related to Importance of communication and how to improve it

Why is communication important in personal relationships?

Communication is essential in personal relationships because it helps build trust, resolve conflicts, and foster deeper connections. Effective communication ensures that both parties understand each other's needs, expectations, and emotions, leading to a more harmonious and fulfilling relationship.

How does effective communication impact workplace productivity?

Effective communication in the workplace leads to better collaboration, fewer misunderstandings, and more efficient problem-solving. When team members clearly understand their roles and responsibilities, it reduces errors and increases overall productivity. Additionally, open communication fosters a positive work environment, boosting employee morale and engagement.

What are some common barriers to effective communication?

Common barriers to effective communication include language differences, cultural misunderstandings, emotional barriers, and physical distractions. Additionally, assumptions, stereotypes, and lack of active listening can also hinder clear communication. Recognizing and addressing these barriers is crucial for improving communication.

How can active listening improve communication skills?

Active listening involves fully concentrating, understanding, responding, and remembering what is being said. It improves communication by ensuring that the listener accurately receives and interprets the speaker's message. This practice helps build empathy, reduce misunderstandings, and foster a more respectful and productive dialogue.

What are some practical tips to improve communication skills?

To improve communication skills, one can practice active listening, be clear and concise, and use positive body language. It's also helpful to ask open-ended questions, provide constructive feedback, and be mindful of non-verbal cues. Additionally, being open to feedback and continuously working on self-awareness can significantly enhance communication abilities.

Similar threads

A Uncertainty estimation in pgopher
    • Atomic and Condensed Matter
Replies
1
Views
792
I Uncertainties from linear interpolation
    • Set Theory, Logic, Probability, Statistics
Replies
30
Views
2K
Satellite communications project
    • Engineering and Comp Sci Homework Help
Replies
4
Views
1K
A Linear combination of data with uncertainty
    • Set Theory, Logic, Probability, Statistics
Replies
5
Views
1K
Writing: Input Wanted Can a Gamma-Ray Burst Affect Communication Devices?
    • Sci-Fi Writing and World Building
Replies
6
Views
1K
Tonga eruption shockwave and weather station(s) in Poland
    • General Discussion
Replies
2
Views
1K
Finding Meaningful Work: Career Advice for Young Scientists
    • General Discussion
Replies
15
Views
853
Simple overestimate of slope uncertainty in regression
    • STEM Educators and Teaching
Replies
11
Views
2K
B Quantum Entanglement Communication Radio
    • Quantum Physics
Replies
1
Views
1K
A How to perform a fit with correlated variables
    • Set Theory, Logic, Probability, Statistics
Replies
16
Views
2K

Hot Threads

Recent Insights

Back
Top