We’re rewarding the question askers & reputations are being recalculated! Read more.
2 added 317 characters in body
source | link

I've never seen such an unreadable piece of code.

All those comments between code lines will only get in the way. You should write self-documented code and perhaps considering a comment before the function.

Then, if you really have the need to have comments between code lines, at least write them before an important (or not so easy to understand) piece of code, in an empty line and with the same padding as the code below.

Edit

To clarify, even with syntax highlighting the comments look out of place to the code itself, because of missing paddings.

For a better readability, paddings and empty lines are great at separating different portions of code. Together with syntax highlighting, you obtain a greater code readability.

I've never seen such an unreadable piece of code.

All those comments between code lines will only get in the way. You should write self-documented code and perhaps considering a comment before the function.

Then, if you really have the need to have comments between code lines, at least write them before an important (or not so easy to understand) piece of code, in an empty line and with the same padding as the code below.

I've never seen such an unreadable piece of code.

All those comments between code lines will only get in the way. You should write self-documented code and perhaps considering a comment before the function.

Then, if you really have the need to have comments between code lines, at least write them before an important (or not so easy to understand) piece of code, in an empty line and with the same padding as the code below.

Edit

To clarify, even with syntax highlighting the comments look out of place to the code itself, because of missing paddings.

For a better readability, paddings and empty lines are great at separating different portions of code. Together with syntax highlighting, you obtain a greater code readability.

1
source | link

I've never seen such an unreadable piece of code.

All those comments between code lines will only get in the way. You should write self-documented code and perhaps considering a comment before the function.

Then, if you really have the need to have comments between code lines, at least write them before an important (or not so easy to understand) piece of code, in an empty line and with the same padding as the code below.