---
title: "Discussion on \"Clean code - Why comments in your code are discouraged?\" | Hashnode"
description: "Discussion on \"Clean code - Why comments in your code are discouraged?\". A guide to writing clean code without any comments to explain it."
url: "https://hashnode.com/posts/clean-code-why-comments-in-your-code-are-discouraged/60d6e98cde92ef110afdd772"
---

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

Discussion

# [Clean code - Why comments in your code are discouraged?](https://divyeshsharma.com/clean-code-why-comments-in-your-code-are-discouraged?utm_source=hashnode&utm_medium=feed)

A guide to writing clean code without any comments to explain it.

Jun 26, 2021 · 3 min read · divyeshsharma.com  
Read the article

-   [#clean-code](https://hashnode.com/tag/clean-code)
-   [#csharp](https://hashnode.com/tag/csharp)
-   [#design](https://hashnode.com/tag/design)

## Written by

[Divyesh Sharma](https://hashnode.com/@dsharma3)

@dsharma3

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

Pragmatic Programmer

## Responses 2

Markdown supported · ⌘↵ to post

[kndb](https://hashnode.com/@kndb)

[Jul 28, 2021](https://hashnode.com/posts/clean-code-why-comments-in-your-code-are-discouraged/60d6e98cde92ef110afdd772/comment/61018d392db92534dc933c9c)

Alternatively, if done the right way, code comments would be a developers bestie.

Some guidelines around writing code comments  
[StackOverflow Blog](https://stackoverflow.blog/2021/07/05/best-practices-for-writing-code-comments/)

[Divyesh Sharma](https://hashnode.com/@dsharma3)

[Jul 30, 2021](https://hashnode.com/posts/clean-code-why-comments-in-your-code-are-discouraged/60d6e98cde92ef110afdd772/comment/61018d392db92534dc933c9c#reply-6103ffc5805a765b08876c0e)

Thanks for sharing :)

[Sam Cutler](https://hashnode.com/@samcutler)

[Jun 26, 2021](https://hashnode.com/posts/clean-code-why-comments-in-your-code-are-discouraged/60d6e98cde92ef110afdd772/comment/60d6fbcacb0aa8118c23b136)

Very nice article, i indeed like the idea of writing comments not on the logic but on the api docs or copyrights. Thanks for sharing!!

[Divyesh Sharma](https://hashnode.com/@dsharma3)

[Jun 26, 2021](https://hashnode.com/posts/clean-code-why-comments-in-your-code-are-discouraged/60d6e98cde92ef110afdd772/comment/60d6fbcacb0aa8118c23b136#reply-60d6fc17cb0aa8118c23b140)

Thanks, Sam, Appreciate your feedback. Do follow for keeping up with more such articles!!
