---
title: "Discussion on \"Why Code Comments Should Focus on Reasons Over Actions\" | Hashnode"
description: "Discussion on \"Why Code Comments Should Focus on Reasons Over Actions\". Introduction\nLet’s get straight to the point: If your code is well-written, the functionality should be self-explanatory.\nThe what is clear from the code itself.\nWhat isn’t always obvious is the why behind your approach — the reason for your decision..."
url: "https://hashnode.com/posts/why-code-comments-should-focus-on-reasons-over-actions/6745b85a1d47fc08cdb30661"
---

[Feed](https://hashnode.com/feed) /

Discussion

# [Why Code Comments Should Focus on Reasons Over Actions](https://codewithpres.hashnode.dev/why-code-comments-should-focus-on-reasons-over-actions?utm_source=hashnode&utm_medium=feed)

Introduction Let’s get straight to the point: If your code is well-written, the functionality should be self-explanatory. The what is clear from the code itself. What isn’t always obvious is the why behind your approach — the reason for your decision...

Nov 26, 2024 · 6 min read · codewithpres.hashnode.dev  
Read the article

-   [#best-practices](https://hashnode.com/tag/best-practices)
-   [#commenting-practice](https://hashnode.com/tag/commenting-practice)
-   [#code-comments](https://hashnode.com/tag/code-comments)
-   [#readability](https://hashnode.com/tag/readability)
-   [#readable-code-techniques](https://hashnode.com/tag/readable-code-techniques)

## Written by

[Preston Mayieka](https://hashnode.com/@preston176)

@preston176 · Eldoret, Kenya

  
[View profile](https://hashnode.com/@preston176)

Technical Writer, Tech Enthusiast, Web developer

I enjoy solving technical problems, researching and developing new technologies, designing software applications for different platforms.

## Responses

Markdown supported · ⌘↵ to post

No responses yet.
