Reddit -> Beehaw until I decided I didn’t like older versions of Lemmy (though it seems most things I didn’t like are better now) -> kbin.social (died) -> kbin.run (died) -> fedia.

Japan-based backend software dev and small-scale farmer.

  • 0 Posts
  • 45 Comments
Joined 2 years ago
cake
Cake day: August 14th, 2024

help-circle









  • The documentation I mean here should be in the repo and checked as a part of the PR process. I don’t mean it should be a manual, I just mean a readme should at least describe what the service does (it has such a generic name in my case that it’s not self-evident and is so broad in scope I don’t know what happened). The functions also have terrible naming and no comments to describe what they do. So, as a guy just coming into this team after re-org with no idea what all this stuff does, I was completely lost. They also changed which services which teams owned, further making it difficult to get knowledge.



  • I recently got moved to another team after my company restructured. Several repos have zero documentation. Most of those don’t even have comments on the functions. LinkXxxx(some args) like Xxxx to /what?!/ It’s also an over-engineered mess with multiple layers of abstraction. I can’t wait to finish figuring out what everything does and re-write (and document it) like a sane person. This code presumably had no AI involvement which I’d argue is even worse since real humans made these shit decisions. Don’t get me starting on their testing (and mostly lack thereof)…

    Worker suggested using AI to write some documentation. Another coworker did. I immediately spotted a bunch of hallucinated shit. Good times. I want to know in my head what a thing does, how it works, and how it fits into the architecture. I can’t do that if an AI is just deciding stuff; it’s like a quiz back in school where I would memorize shit for about one week before 99% of it left my brain forever.



  • There’s an XKCD for that as always: https://xkcd.com/386/

    If the person does not seem like they would be receptive to seeing another view point, I probably just ignore (and, if transphobic, racist, sexist, etc., typically block the person). Every once in a while I might make a comment and judge the reaction first.

    If the person seems like they actually want to consider their and other positions, I might make a comment with some back and forth.

    I guess the exception to that is when I see posts like ‘Japan is like X’ or ‘All Japanese people do Y’ and it’s just plain wrong. In those cases, I will always post at least once.

    I also work a fulltime job, have a small farm, and have a house to maintain so I’m not typically swimming in free time for arguments anyway.