• 1 Post
  • 19 Comments
Joined 1 year ago
cake
Cake day: July 4th, 2023

help-circle



  • Comments get stale and over time transition from: accurate to outdated, to eventually flat-out lies.

    Sounds like some people aren’t doing their work enough then. Code comments are part of the work that a programmer should do, not an afterthought. Who else is gonna update that code if not the programmer? And if a programmer isn’t supposed to update their code and we can just all write clean code that would somehow make us all be better engineers (yeah, I use this title differently from programmers), then why are code comments even a thing?

    Self-documenting code is good and all, but so should there be good comments.




  • Hard disagree that documentation is a waste of time. I think you’re just failing to see and use documentation correctly.

    Tech documentation should never:

    • record implementation details; that’s what commits and PRs are for
    • be about the code, but about the solution, information, or provide guidance; use code comments when talking about code
    • be taken as 100% accurate or infallible, but the general direction or essence should still remain true (related to the 2nd point)
    • be expected to be up-to-date; readers should always look at the created / completed / last edited date and make a judgement how much salt to actually take from it

    Documentation can

    • be some kind of paper trail that shows how we got to where we are
    • provide guidelines for getting started on a project, or some part of a larger project, with more context with respect to the business, so that readers are equipped with sufficient context when diving into the code (READMEs can then just focus on setup and testing instructions)
    • go further into what goes around a solution, eg considered alternatives, what actually requires solving given a functional requirement (it’s not always the case that we can fit a solution within a sufficiently small ticket, so tickets might be too localized to give a bigger picture of how a problem is being solved)
    • record system architecture, with actual illustrations, which can be easier to grok than 50 Terraform files

    Writing these out is also good for people who don’t read code or don’t have the time to read code, eg your tech lead, your manager, Tech VP, etc, people who should have some idea of your system or solution, but not necessarily the implementation detail, so that they can do their work more effectively.

    There’s also a culture where a project, or a sufficiently complex problem, starts with a tech proposal, which would properly capture the problem and do solution planning. It’s easier and faster to change than a PR, and reviewers can read that for context. In any case, this democratizes knowledge, instead of creating more tribal knowledge.


  • It’s not possible for everyone to just tell if it’s supposed to be sarcasm. ADHD makes it hard. A bad day makes it hard. A tiring day makes it hard.

    The downside of the misunderstanding isn’t just downvotes. It’s possibly a proliferation of misinformation and an impression that there are people who DO think that way.

    Being not serious while saying something grim is not a globally understood culture either. It’s more common and acceptable in the Western world as a joke.

    So… call it accessibility, but it’s just more approachable for everyone to just put an “/s”.


  • Lots of moments in Honkai Impact 3.

    There’s literally a YT channel that collects tears from streamers playing the game.

    https://youtube.com/@Ollyt_

    There’s a lot of context needed to understand why anyone would cry playing through HI3 though. I’ll give a high level summary here, but I highly encourage people to play it, even if it’s a gacha game. You can really ignore the gacha and just play the game for the main story. Do be warned that the story isn’t something suitable for kids — it can be quite a bit too heavy for them.

    The theme of self-sacrifice is covered quite extensively, with the main character being the centrepiece of the theme. There’s also deep self-loathe, with an eventual self-acceptance, also from the MC. Mix that all in with some sense of duty.

    There’s also a tragedy, but from the tragedy, a narrow path to hope was born. The people in the tragedy mostly hoped only for a simple life, or to live their lives atoning for their sins, but circumstances forced them to become warriors against a great, unstoppable force of destruction. As if to make things harder to swallow, their digital clones that survived into the future have to experience yet another tragedy that would eventually destroy all of them, and the player will see this through. Yet, in the second tragedy, these clones further sowed the seeds of hope for the future.

    Chinese company or not, HoYo has pumped out a lot of very human stories that I think deserves attention and praise. Genshin Impact has also started to go down a similar path.





  • I intended to give an explanation, but since this community is pretty general, i.e. we have people from basically all walks of life here, many with little to no involvement or understanding of the tech industry, so I decided to leave it out cause it would be too much to explain.

    rolauten@startrek.website has given us a pretty brief explanation, but I think it can be further simplified, though would require a lot more knowledge build up (i.e. more words). If anyone’s interested, I can try to write a fireplace story, though I can’t say I’m the most qualified person to do so, or give an absolutely accurate story.



  • Just putting this out cause the “predominantly Muslim” comment tilts the blame fully into Muslims. There are many non-Muslims in the country that are homophobic, and openly so. Homophobia isn’t just a religious problem, even though it looks like it generally is in the West. I’ve heard of the worst comments from non-Muslims, and I’ve heard of the best supportive statements from Muslims in Malaysia. Generally, the younger generation is more accepting, while the older generation is much harsher on LGBTQ+.

    That said though, the government is still run by old farts, many of whom are, welp, old. It’s why we see these kinds of non-sensical laws coming out of their parliament. It’s even funnier if you look at other things they’ve rolled out in the recent years or even months.



  • Badland9085@lemm.eetolinuxmemes@lemmy.worldAverage Arch exp
    link
    fedilink
    arrow-up
    12
    arrow-down
    1
    ·
    1 year ago

    While this echoes some other comments, this meme should go soon. I’ve used Arch for years at this point, and if there’s ever something wrong, it’s generally my fault, and the official announcement and mailing list do a pretty good job telling you what you should do before upgrading your system. Install a tool informant to check for unread news for you for when you try to update, and stop your upgrade transaction if there are news you haven’t read. These announcements are pretty rare. My system’s also been rock solid. I read that they have an official installer now to help ease installation. Things are pretty great with Arch.

    On the other hand, Ubuntu has been a pain in the ass. Putting aside the horrible experience with dist-upgrade, Gnome has been the most painful DE I’ve ever used.

    • Odd resizes of my windows on sleep & wake on a multi-monitor setup.
    • Randomly spawn the password prompt on sleep & wake, with no way to remove the prompt unless I do a pkill gnome-shell and let the DM restart gnome-shell.
    • Software Centre can just randomly fail to fetch package updates. Update installs through software centre can also fail with the most unhelpful messages.
    • Software centre will stop a full update if there’s an app in the list that’s running. Arguably a feature, but not all apps require that. That decision should be left to the discretion of the app maintainer. Users can individually update other apps to circumvent the problem, but that’s a paper cut to me.