• 1 Post
  • 116 Comments
Joined 2 years ago
cake
Cake day: June 12th, 2023

help-circle


  • waigl@lemmy.worldtomemes@lemmy.worldSmugly
    link
    fedilink
    English
    arrow-up
    11
    ·
    7 months ago

    After googling around for a bit, and then switching to duckduckgo instead (Google becomes aggressively unhelpful as soon as you have words like “ejaculated” in your query. Duckduckgo does the same thing, just not quite so much.), it seems the book in question might be “The tenant of Wildfell Hall” by Emily Brontë.









  • waigl@lemmy.worldtoProgrammer Humor@programming.devUniversity Students
    link
    fedilink
    English
    arrow-up
    24
    ·
    edit-2
    8 months ago

    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.






  • “What is the remaining market value of your car?” is a massively important question for every car owner needing to have their finances in order. New cars depreciate faster than old ones, expensive cars depreciate faster than cheap cars. It is said that, when you buy a brand-new luxury sedan, just the simple act of driving it off of the lot will cost you easily 5000 dollars.

    If you are not even allowed to sell your car, its market value at that point in time is effectively zero dollars. Keep that in mind when deciding what to buy.