---
title: "Comment by Ivan Pedrazas on \"The Most Undervalued Skill of Programmers\" | Hashnode"
description: "Problems can be avoided by making these hidden connections between code visible using comments. While the statement is correct it highlights a problem that I th"
url: "https://hashnode.com/posts/the-most-undervalued-skill-of-programmers/626534d65dd5677e9b8de6ad/comment/626d057fa2d355d4df43e6b3"
---

[Discussion](https://hashnode.com/posts/the-most-undervalued-skill-of-programmers/626534d65dd5677e9b8de6ad)

Comment [The Most Undervalued Skill of Programmers](https://hashnode.com/posts/the-most-undervalued-skill-of-programmers/626534d65dd5677e9b8de6ad)

[Ivan Pedrazas](https://hashnode.com/@ipedrazas)

[Apr 30, 2022](https://hashnode.com/posts/the-most-undervalued-skill-of-programmers/626534d65dd5677e9b8de6ad/comment/626d057fa2d355d4df43e6b3)

> Problems can be avoided by making these hidden connections between code visible using comments.

While the statement is correct it highlights a problem that I think it requires more attention. What you call "hidden connections" can be described as "cognitive load" and in this case, the need of having to add a comment to make it "safer" signals that the interface has not been properly designed (the Kafka interface that exposes those keys to be modified).

Comments are our last line of defence against poorly defined dependency interfaces.

[Ruben Scheedler](https://hashnode.com/@RubenScheedler)

[Apr 30, 2022](https://hashnode.com/posts/the-most-undervalued-skill-of-programmers/626534d65dd5677e9b8de6ad/comment/626d057fa2d355d4df43e6b3#reply-626d1f1eb7dcabd258e76711)

Good point! Preferably, these hidden dependencies would not be hidden in the first place, but rather visible through interfaces.
