Sometimes when I don’t leave comments like that, I get review comments asking what the line does. Code like ThisMethodInitsTheService()
with comments like “what does this do?” in the review.
So now I comment a lot. Apparently reading code is hard for some people, even code that tells you exactly what it does in very simple terms.
If you’re hoping for the standard lib to have things built on evolving standards and ecosystems like HTTP clients, then I doubt that will ever happen. There are plenty of examples of why that would be a terrible idea (
urllib
,std::regex
, etc).