RE: Updates to sendemtiny.exe
I've written a lengthy readme visible on the github project page which details what the project is for, how it works, a tutorial with many screenshots, and the "quick guide" image at the top of this post, which I hoped would quickly give the concept. I've also updated the readme with the updates given here. If you have a specific question, please ask here or on the Discord (pengo)
The initial version had every single functional line commented as well as having a lengthy readme with many screenshots and still received a Utopian comment score of "Very low - the added comments provide no value or are not present at all." I have had feedback from users who have no problem using the tool, so I'm at a loss for how to provide adequate documentation for the utopian project.
I have seen you have commented on your code but what I mean is that some of the complex logic is still missing the documentation or comment. Let's say for example, you have written a regex, which is quite big,
var regex = new Regex(@"[Uu][+-]?(?<hex>[0-9A-Fa-f]{2,})|say\W(?<say>.*)|type\W(?<type>.*)|(?<entity>&(?:[a-z\d]+|#\d+|#x[a-f\d]+);)|(?<time>(?<num>\d+(?:\.\d+)?)\W*(?<unit>s|ms))");Now if I am a newbie in the project I will not understand what exactly this Regex does, so explaining it would be highly appreciated. Thus we say that commenting and explaining the complex logic is necessary for open source project because that helps the people who will be using your code.
Fair enough. I'll definitely break that up and/or comment it more when I next have a chance to work on it.