Hey George, I really appreciate you taking the time to write such a detailed response.
Your point on the comments is a battle I have with myself almost every single day.
I completely agree with the clean code principles (you'll notice none of the content of the code contains comments). Tidy self documenting code is something we should all strive for.
That said, well documented public endpoints allows people to use the Core library without actually looking at the code. So I think there is a worthwhile trade off there.
Thanks for the input though, I do always appreciate it!
Hey George, I really appreciate you taking the time to write such a detailed response.
Your point on the comments is a battle I have with myself almost every single day.
I completely agree with the clean code principles (you'll notice none of the content of the code contains comments). Tidy self documenting code is something we should all strive for.
That said, well documented public endpoints allows people to use the Core library without actually looking at the code. So I think there is a worthwhile trade off there.
Thanks for the input though, I do always appreciate it!
I absolutely understand that and my apologies if my comment bothered you. That wasn't my intention anyway.
In any case, have a great day!
It didn't bother me in the slightest :-) I always like having a discussion about things and try to reply to all comments.
Same to you :-)