• 33 Posts
  • 260 Comments
Joined 1 year ago
cake
Cake day: June 12th, 2023

help-circle











  • Writing good comments is an art form, and beginner programmers often struggle with it. They know comments mostly from their text books, where the comments explain what is happening to someone who doesn’t yet know programming, and nobody has told them yet that that is not at all a useful commenting style outside of education. So that’s how they use them. It usually ends up making the code harder to read, not easier.

    Later on, programmers will need to learn a few rules about comments, like:

    • Assume that whoever reads your code knows the programming language, the platform and the problem domain at least in general terms. You are not writing a teaching aid, you are writing presumably useful software.
    • Don’t comment the obvious. (Aside from documentation comments for function/method/class signatures)
    • Don’t comment what a line is doing. Instead, write your code, especially names for variables, constants, classes, functions, methods and so on, so that they produce talking code that needs no comments. Reserve the “what” style comments for where that just isn’t possible.
    • Do comment the why. Tell the reader about your intentions and about big-picture issues. If an if-statement is hard to parse, write a corresponding if clause in plain English on top of it.
    • In some cases, comment the “why not”, to keep maintenance programmers from falling in the same trap you already found.

  • I wonder when, if ever, Warner Bros. Is going to learn that players are actively pushing back against corporate greed and live service games are already way past the limit of microtransactions that players deem acceptable.

    Some time after that actually happens.

    Yes, there are a lot of players in various social networks loudly complaining about the phenomenon (although I suspect many of those are not even in the target audience to begin with), and there are even some actively boycotting these games, but so long as there are enough of them left willing to play ball, and especially some with an exploitable addiction-prone personality that can be hooked on loot boxes and microtransactions until they spend more than they have, there just isn’t anything for these companies here to “learn”. Other than “hey, this is insanely profitable”.

    They may get insulted on Xitter for it, but who cares, everybody gets insulted on Shitter…