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.
tiredofsametab
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
- 600 Comments
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.
tiredofsametab@fedia.ioto
Ask Lemmy@lemmy.world•What are some foods that LOOK awful but TASTE great?
2·3 days agoI can see it, but I’d think there’d be a better source of acid/sour that isn’t as fatty to pair with the PB.
tiredofsametab@fedia.ioto
Ask Lemmy@lemmy.world•How do you stop arguing with people on social media?
2·3 days agoThere’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.
tiredofsametab@fedia.ioto
Technology@lemmy.world•Pee and Poop in Your Car While Driving at 100 km/h to be Possible
11·5 days agoOh yeah? Well, I’ve pooped at a significant fraction of the speed of sound
tiredofsametab@fedia.ioto
Europe@feddit.org•Have you seen US defaultism in real life while they're in Europe?
10·5 days agoI’ve seen a couple of things in Japan if that datapoint matters. Twice about accepting USD, and a few times getting mad about people not speaking English.
I’ve seen people (not just Americans, though) do things that are illegal here because they couldn’t imagine it being illegal in their home country. Cycling after any alcohol, cycling with earphones, cycling holding an umbrella, various waste disposal laws, picking up money and not reporting it (technically theft here even if it’s forgotten change in a vending machine, but that never gets enforced that I’ve seen), and just other minor stuff.
Americans in particular love to consider self defense as “if you say something I don’t like or throw the first punch, I can fight you” which is just wrong in Japanese law (only the amount of force needed, and no more, to get out of the situation to safety is legal; you can’t punch someone just because they punched you).
Edit: also pocket knives; we have very strict laws here and lots of Americans in particular (but I’m sure others) carry them without thinking and can get in huge trouble for it.
smear wasabi on sushi
There is nothing wrong with this. Sushi cehfs put it on the underside. If you want more, put it on top. It’s generally considered bad manners to mix soy sauce with wasabi and dunk but, to be honest, I see that fairly frequently here in Japan as well. Mixing soy sauce and wasabi to pour over chirashi is fine.
The only thing wearing gloves does is keep your hands clean.
That’s not true when gloves are used properly (only put on with clean hands, changed when appropriate, etc.). Of course, the number of people/places that do not do those things…
Cilantro tastes like bug spray to me and no amount of eating it anyway has helped and any significant amount ruins whatever I’m eating. That said, the only time I bring it up is in conversations like these.
tiredofsametab@fedia.ioto
Not The Onion@lemmy.world•Uganda Special Ops Commander asks Turkey for $1 billion and a wife
4·8 days agoI’m cheaper! I’ll do it for having my student loans paid off, my house paid off, and some spending money; I don’t even need the wife!
tiredofsametab@fedia.ioto
Technology@lemmy.world•PSA: If you use the Meta AI app, your friends will find out and it will be embarrassing | TechCrunch
4·9 days agoI stopped. Anyone who wanted to keep in touch with me was given other methods of doing that. Anyone else who couldn’t be bothered to spend 20 extra seconds? Not worth having in my life.
Usually 8 +/- a bit. I have become a lighter sleeper in my 40s and do wake up at least once most nights (excluding earthquakes because that’s not something I can help). My neighbor starts work really early and has to drive a heavy vehicle so that starts around sun-up (5:30 now but will be 4:30am in mid summer) so I try to adapt my schedule. It’s not that bad since my second job is farming and it’s much better in the early morning before the oppressive heat and humidity here.
tiredofsametab@fedia.ioto
Ask Lemmy@lemmy.world•When do Americans actually do the taxes? On January 1? Or do y'all like procrastinate till April 15?
4·11 days agoBefore I had to wait on slow 1099s: as soon as the IRS and the software I used had the forms all set up.
Now: whenever the last slow-assed company sends me a 1099 which is sometime in March null
I want to do things ASAP and have them done, so that’s hard. As an overseas citizen, I do get an automatic 6-month extension, but I’ve never had to come anywhere close to the normal deadline, even.
tiredofsametab@fedia.ioto
Not The Onion@lemmy.world•"God, you're hot" school board member Keith Ervin not removed from school board.
341·11 days agoDude’s electronics should have been seized and searched immediately.
tiredofsametab@fedia.ioto
Not The Onion@lemmy.world•Man bites woman at cherry blossom park in Japan, dies shortly after
1·12 days agoI wasn’t offended/bothered at all.
tiredofsametab@fedia.ioto
Not The Onion@lemmy.world•Man bites woman at cherry blossom park in Japan, dies shortly after
14·13 days agoYou say “/s” but, for anyone else reading, Japan is considered rabies free so that would certainly be a big deal we’re it the case.
tiredofsametab@fedia.ioto
Ask Lemmy@lemmy.world•For those of you with a living room or multiple rooms; do you have a TV in your bedroom? Why or why not?
5·15 days agoNo bedroom TV. As an ADHD person, that’s just a ‘never-going-to-sleep’ trap. I do have a list of youtube channels I put on my phone at lowest volume and screen off for background noise. It can’t be too interesting or I won’t sleep; it just needs to keep my mind from wandering in bad directions.
tiredofsametab@fedia.ioto
Ask Lemmy@lemmy.world•What do you keep in your pockets and which pocket do you keep them in?
2·16 days agoLeft front: phone
Right front: wallet and hand towel
Back belt loop: keys on caribeener
tiredofsametab@fedia.ioto
Ask Lemmy@lemmy.world•When countries around the world start enforcing biometrics and digital passports for travel, would you still do traveling or just hide in some farm off grid?
3·16 days agoJapan has required fingerprints and photo for at least a decade now. Korea required the same when I was recently there.

It is agreed to in the sense that it’s part of the social contract. People not doing it could face social consequences.