This comment is hidden because it contains spoiler information about the solution
I forked his translation to update it to Rust 1.44 .
I also moved the reference solution to the test module
Can someone explain this sorcery?
Some language versions doesn't have random tests.
Y'all need to use parentheses.
"Turn a trivial math problem into a program" is neither new nor interesting kata idea.
Author solution is incorrect ;-)
The comments in your solution make me ignore it and move on.
relaxing but instructive
Commenting code which does magic now considered a bad practice? By who?
If it's math magic, it is still magic.
Names trick does not help here at all, btw.
Are you trolling? This is a one line function which is 8 characters long. We have no control over the function name/ file name. Explaining the programming language/ framework, or in this example, plain old math, is considered a bad practice.
You may argue that because 'it is helpful to translate the meaning of some obscure argument or return value into something that’s readable.' Or that 'when [the code] is part of the standard library, or incode that you cannot alter, then a helpful clarifying comment can be useful.'
But to explain math to a future programmer in the comments would be considered harmful noise. This is because important comments will just be ignored after a while.
The adage: 'Don’t Use a Comment When You Can Use a Function or a Variable' is applicable here. I convert this block to english like so: 'To sum the row of odd numbers, I cube the row index'. I cannot see any value in adding a comment here.
Yes, indeed. Do not write comments where code is clean.
How can clean code in this example explain anything? Why you should believe this code is right?
Another people said so?
Read clean code. It recommends the exact opposite.
To make people who read you solution to understand it.
Not a best solution with a good explanation in real world worth much more, than ideal solution
with no explanation.
Supporting projects with lack of comments is always a pain. Try it once to feel it.