• 0 Posts
  • 67 Comments
Joined 4 months ago
cake
Cake day: July 22nd, 2024

help-circle
  • I find it extremely frustrating how weirdly wrong-density much documentation is. It’s extremely detailed in all the wrong places and often lacks examples for common use cases.

    I learned a while ago that news articles are supposed to have increasing levels of detail from top to bottom. Each paragraph adds a bit more context, but the general picture should be contained in the first one. Hardly any documentation follows that pattern.







  • That depends, actually.

    In general, I try to keep everything English, since we do have some international colleagues.

    However, I work with a bunch of projects that have some legal/administrative background and certain words have very precisely defined meanings, that can’t be easily translated (at least not in one word, so that the next guy can back-translate the word). So in these cases, I sometimes write comments that explain the domain problem in German, because it’s much much easier and whoever touches that code better understand the German terms or screw everything up. Unfortunately class and method names are often a weird language mix.

    It’s not a perfect solution, but given the legal complexities behind seemingly simple words, it’s the best of the worst.




  • Oh come on, are you really that boneheaded not to understand that you’re not the norm?

    I literally had not a single power surge in my entire life. The only power outages I had were for a few minutes maybe three times in the last 15 years.

    The larping refers to you. Either you are truly an outlier who actually runs a small DC, or you just like the feeling you can get pretending to do so.

    Your attitude is roughly the “only gold plated cables made from solid silver” equivalent in audiophiles. Technically maybe correct, practically a self-important waste of money.



  • But not for us.

    That’s what I meant by larping. The vast vast majority of us here would probably not even notice if their systems went down for an hour. Yes, battery backup has its purpose. In a datacenter.

    I mean, what’s on the line here in the worst case? 15min without jellyfin and home assistant? Does that warrant taking risks with old batteries or investing in new ones?

    That equation might change if you’re in a place with truly unreliable electricity, but I guess those places have solutions in place already.