I think that, in many cases, “what” and “why” are very similar to each other or are closely related.

I’ve had an experience like this on more than one occasion - I come into an established code base for the first time. I’m working on a new feature/refactor/bug fix. I am reading through a function that is relevant to me, scratching my head a bit, and thinking “I think I see what this function is doing, but why did they do it such a screwy way?” Often there are no comments to give me any clues.

In the past, I have foolishly changed the code, thinking that I knew better… But what often happens is that I soon discover why my predecessor did something that looked so weird to me. They weren’t stupid - there was a reason for it! And then I end up putting it back…

Point being, in a situation like that the “what” and the “why” are going to have a lot of overlap. So, personally, I try to write comments that highlight assumptions that won’t be obvious from reading the code, external constraints that matter but don’t actually show up in the code, and so on.

I am far from perfect at it and I probably don’t write enough comments. But when I do, I try to write comments that will be reminders to myself, or fill in gaps in context for some hypothetical new person. I try to avoid comments that literally explain the code unless it’s particularly (and unavoidably) complex.

Glory to you and your house!

“Why” comments make more sense as application complexity grows.

You also have to consider interaction of the code with other external systems - sometimes external APIs force you to write code in ways you might not otherwise and it’s good to leave a trail for others on your team (and your future self…) about what was going on there.

C seems like an awfully painful way to write the CRUD apps most of us spend our time on.

And any performance gains would be invisible in most situations where network I/O is the biggest bottleneck (almost) regardless of the language used.

I know this may be an unpopular opinion on lemmy, which leans so heavily towards Linux and FOSS, and I’m a Linux user myself but….

I actually really like C# and .NET (the modern cross-platform version anyway).

And this is why mocks are bad…

Ah, the list of required skills on the last job posting I looked at…

O’Brien is my favorite character in all of Trek. And as much as part of me would like to see him again, sometimes a character’s story is over and that’s ok!

I generally agree with the idea that code should be as simple as it can be to accomplish the goal of the code… I just haven’t been convinced that Clean Code is the way to get there, necessarily. The book does contain some good advice , to be sure, but I wouldn’t call it universal by any means.

I also think TDD is a very optimistic strategy that just doesn’t match up with reality terribly often.

Actually, I think that’s what confuses me the most about all of Uncle Bob’s books. I’ve read a couple of them and thought, “All this sounds great but real world development just doesn’t seem to work that way.” Like, all of his advice is for best case scenarios that I certainly haven’t encountered in my career.

I say confusing, because surely he’s been in the profession long enough to have seen the disconnect between what he’s preaching and real life, right???

Oof…

I love SNES Starfleet Academy. I played battles in the simulator mode over and over again so many times as a kid.

Do we work together?

Thanks!

I need to know where you got this. Please…

How is it that no one has mentioned the Star Trek Starfleet Command series???

Starfleet Command Orion Pirates is a fantastic game and one of my favorites of all time!

I really enjoyed Starfleet Academy on SNES. But my favorite games were the Star Trek: Starfleet Command games on PC, especially Starfleet Command Orion Pirates.

Like Blazor, it’s another way to do SSR.

The perspective is interesting and enlightening. For me, TNG was MY Star Trek. The first episode aired when I was 5 years old and I watched every episode with my dad over the seven year run.

Part of me grew up on the Enterprise D!

We should be so lucky…

The Wounded!