News for hackers. Stuff that matters.
Re:Mindsets to Avoid as a Senior Software Developer by aequitas on Tuesday March 02, 2021 @10:37AM (#26316364)
One thing I've learning is code review should never be used just as gate-keeping for the senior developers.

Rather, let everyone (juniors, QA, non-developers) in the team perform reviews of everyones code, even your senior code. Not only is it a great way to spread/communicate knowledge and understanding in the team. But everyone looks at your code with a different eye and background.

You may have written the greatest opus magnum of your programming career. But if the junior or medior can't make sense of it, they will not be able to maintain it when you're gone. So effectively you have failed.

Re:Mindsets to Avoid as a Senior Software Developer by capableweb on Tuesday March 02, 2021 @10:43AM (#26316433)
> You may have written the greatest opus magnum of your programming career. But if the junior or medior can't make sense of it, they will not be able to maintain it when you're gone. So effectively you have failed.

Overall I agree with you, yeah. But also no. Of course the code should be as simple to understand as possible, but if the junior or medior doesn't understand matrices, nothing I do will make them understand them.

So I mean, yes, but also no. Sometimes it's OK to expect people to have some domain knowledge. Doesn't mean your code should be spaghetti of course.

Re:Mindsets to Avoid as a Senior Software Developer by lhorie on Tuesday March 02, 2021 @11:32AM (#26317061)
> if the junior or medior doesn't understand matrices, nothing I do will make them understand them

Oh but there are things we can do. We can add comments that link to resources, we can write long prose (both inline in comments and in out-of-band documents such as RFCs and documentation) explaining why we're using something that nobody else in the team understands vs the alternatives, and we can level people up via informal sessions like lunch-and-learns, info sharing sessions, etc.

It's true that many juniors aren't capable of following concepts above a certain level of difficulty, but it's also not rare for people to really flourish if given a gentle push.

There's definitely a paretto balance when it comes to knowledge sharing. Don't be that person that writes zero docs and hogs all the knowledge when you could spend 20% effort to level up 80% of people to the point where they can start helping each other.

Re:Mindsets to Avoid as a Senior Software Developer by Kalium on Tuesday March 02, 2021 @11:36AM (#26317108)
> Overall I agree with you, yeah. But also no. Of course the code should be as simple to understand as possible, but if the junior or medior doesn't understand matrices, nothing I do will make them understand them.

There is a difference between code that is complex because it needs to be (ex: matrix mathematics) and code that is complex because you wanted it to be (ex: microservices and kafka and obscure functional languages for what could have been a Rails CRUD webapp).

Re:Mindsets to Avoid as a Senior Software Developer by efsavage on Tuesday March 02, 2021 @11:24AM (#26316981)
> if the junior or medior doesn't understand matrices, nothing I do will make them understand them.

Teaching them will.

Re:Mindsets to Avoid as a Senior Software Developer by hinkley on Tuesday March 02, 2021 @12:19PM (#26317667)
You can explain, you can teach, or you can refactor.

Sometimes refactoring is the cheapest of the three, but you won't know until you try to explain/teach it.

Re:Mindsets to Avoid as a Senior Software Developer by eek04_ on Wednesday March 03, 2021 @06:41AM (#26327143)
Often, explaining/teaching has only short term value in terms of the product. The code will outlive the team; I try to factor the knowledge into the code, making the code easy to deal with.

I also spend a lot of time explaining and teaching, as it is necessary, but it's really a stopgap measure. Give it a few years and there's mostly new people.

Re:Mindsets to Avoid as a Senior Software Developer by FroshKiller on Tuesday March 02, 2021 @08:45PM (#26323689)
It was cheaper for me to ask my junior which of two blocks he understood more easily and eliminate the style he didn't grasp immediately throughout the project than it would've been to try to teach him and every programmer that follows him on the project for sure.
Re:Mindsets to Avoid as a Senior Software Developer by efsavage on Tuesday March 02, 2021 @09:34PM (#26324022)
Agreed, but if cheap is your goal, you shouldn't be hiring junior devs. The leanest companies I've seen/worked for were all senior people. "No passengers".
Re:Mindsets to Avoid as a Senior Software Developer by aequitas on Tuesday March 02, 2021 @11:00AM (#26316669)
Maybe they don't have to understand the detailed inner workings of an algorithm and such. But they should be able to deal with that piece of code in abstract. A good comment on what a piece of code is intended to do is perfectly fine to know it's place in a greater whole. Not every developer knows how crypto functions work, but they can make good decisions on how these functions should fit in certain logical scenarios or if an implementation is badly written/documented.
Re:Mindsets to Avoid as a Senior Software Developer by ramy_d on Tuesday March 02, 2021 @10:57AM (#26316622)
yeah I would say in principle this makes sense but in practice a junior will typically say "this is beyond me but you're the senior so if it works, it works!"

It is an opportunity to go through the code and concepts at least.

Re:Mindsets to Avoid as a Senior Software Developer by 8note on Tuesday March 02, 2021 @02:29PM (#26319346)
Do you expect these developers to be able to debug this code after its in production? Or is that bottlenecked to yourself?

Having most of your team not be able to understand the code they support sounds dangerous

Re:Mindsets to Avoid as a Senior Software Developer by zffr on Tuesday March 02, 2021 @01:57PM (#26318935)
> Rather, let everyone (juniors, QA, non-developers) in the team perform reviews of everyones code, even your senior code.

I think the OP is just saying that juniors should be allowed to participate in the reviews of senior engineer code (not that a junior review alone is sufficient for merging a PR).

I think this is a great way for juniors to get exposure to the complex topics they might not yet understand, but should learn more about.

Re:Mindsets to Avoid as a Senior Software Developer by wonder_er on Tuesday March 02, 2021 @12:28PM (#26317802)
> but if the junior or medior doesn't understand matrices, nothing I do will make them understand them.

What if you took a hour or a day to help educate an eager junior developer about what you did in that PR?

I, personally, don't know matrices. I can damn well learn them if it becomes relevant to me.

If we were on the same team, and I said "what's this stuff?" and you said "nothing I can do will make you understand this" I'd be pissed, and that attitude would _permanently sour_ the relationship.

I imagine there was a point in time that _you_ did not understand matrices. I've no doubt that matrices can be tricky, difficult to understand, etc.

So, lets work together on sharing that knowledge! Once you've helped me learn it (pointing me to resources, pairing with me on an example problem solving session involving matrices) I will be able to maintain the code, understand it, and apply the pattern to novel problems.

But not just that, because I am a compulsive documenter of what I've learned, as you teach me, you help me teach _everyone who comes behind me_

TL;DR the attitude of "if jr/med devs don't already understand matrices, nothing I do will make them understand them." is _extremely_ self-limiting, locking you out of tons of potential value, and causing your entire team to be worse off.

It's not your fault, per se. I know this attitude is common in the industry. It just really pisses me off, because so many teams are deeply damaged by it.

(I know, I know. Maybe you'd love to slow down and teach early-career devs, but the feature death-slog required by management precludes you taking that time... in that case this isn't directly your fault, etc.)

Re:Mindsets to Avoid as a Senior Software Developer by gmfawcett on Tuesday March 02, 2021 @12:48PM (#26318038)
In defense of the seniors... It generally takes people several semesters of Linear Algebra to become competent with "matrix stuff." It's unrealistic to expect every senior dev to also be an expert teacher -- never mind expecting them to know what the latest and best learning resources are (for a subject they may have learned, themselves, before the Web was invented).

Sometimes the right and fair substitute for "nothing I can do will help you" is "get yourself a proper education on this subject, somehow, and then we can talk about the code."

Re:Mindsets to Avoid as a Senior Software Developer by peterwoerner on Tuesday March 02, 2021 @01:57PM (#26318940)
I think the issue is that many of us are poor communicators (myself being number 1) so we say nothing I can do will help you instead of I can't teach linear algebra, numerical analysis and do the code review in an hour. Therefore putting a junior engineer who has a weak math background on a code review for my new algorithm which uses spectral sparsification for approximating matrix inverses in n log(n) isn't a good idea.
Re:Mindsets to Avoid as a Senior Software Developer by aequitas on Tuesday March 02, 2021 @02:06PM (#26319054)
But a junior can still ask question like: "why isn't there a test for this code", "why are the business logic and algorithm code mixed together" or "why doesn't this align with the design documentation we wrote last week, does it need updating?".
Re:Mindsets to Avoid as a Senior Software Developer by peterwoerner on Thursday March 04, 2021 @10:03AM (#26343251)
And the junior will learn which things to learn. I certainly think you should allow juniors to code review senior coders work if for nothing more than mentoring, but I am sensitive as to why an overloaded senior would balk at the idea.
Re:Mindsets to Avoid as a Senior Software Developer by Cd00d on Tuesday March 02, 2021 @02:06PM (#26319052)
Wildly off-topic, but I recently learned this. Use asterisks in HN to express emphasis* in italics*. I too used underscores (a la Slack) up until a couple weeks ago when I noticed a comment from Dang somewhere saying how to emphasize.
Re:Mindsets to Avoid as a Senior Software Developer by wonder_er on Thursday March 04, 2021 @10:55AM (#26343968)
aaaah thank you!

I often mis-apply slack/markdown formatting.

Instead, now I will less often mis-apply markdown formatting to hacker news.

Thank you!

And this isn't "wildly off-topic", by the way. This is "extremely germane to what I said, but addresses something other than the specific point I was trying to say."

Doesn't make it not helpful. In fact, I bet there are many situations where this kind of feedback is more (I almost wrongly-formatted that!) helpful than addressing the comment directly.

You, dear internet stranger, have taught me something. Thank you!

Re:Mindsets to Avoid as a Senior Software Developer by Mauricebranagh on Tuesday March 02, 2021 @12:24PM (#26317743)
Shurly the point is you a document it and if required walk them though the code and mentor them.

And not to what some one did mumble years ago when I was taking over the map part of a map reduce product built in PL1/G and say after 3 days "haven't you learnt it all yet"

Re:Mindsets to Avoid as a Senior Software Developer by hyperpallium2 on Tuesday March 02, 2021 @01:25PM (#26318549)
Will it be maintained, and whose fault that is, are separate issues.
Re:Mindsets to Avoid as a Senior Software Developer by vbtemp on Tuesday March 02, 2021 @12:00PM (#26317413)
I enthusiastically believed this in the past, but then I started observing the reverse: Code reviews became gatekeeping for junior developers... In other words, junior developers were using it as opportunities to assert power (via obstruction). Of course this was idiosyncratic to the company and team.

I've become less positive toward code reviews over the years as well - the low-hanging fruit of style checking, linting, and related stuff has been automated away. Moreover, people are busy and when they do code reviews, they are mostly looking for easy stuff to pick at. What ends up getting avoided is the far more important algorithm, design and architecture reviews that really require a much bigger cognitive load.

Re:Mindsets to Avoid as a Senior Software Developer by rightbyte on Tuesday March 02, 2021 @12:47PM (#26318021)
I feel code review is overrated. It makes refactoring and small fixes take like 2h longer. I atleast fill up my parallel tasking slots too fast with small things if they linger in review. So either I don't do them or get less done.

Code review might be good for a subset of code, like retrofitting bugfixes to release branches or babysitting a team of beginners.

Re:Mindsets to Avoid as a Senior Software Developer by gwbas1c on Tuesday March 02, 2021 @03:18PM (#26320039)
Code reviews turn into a formality when everyone is submitting great code. This is a good thing.

BUT: I just joined a team with domain experts who do not have a software engineering background. As I go through the code, there's lots of copy & paste, incorrect error handling, inconsistent (and confusing) variable names...

These developers really can benefit from coaching in a review. The team then benefits because the code is easier to read, robust, and maintainable.

(The codebase is impressive for people who have minimal software background. I've seen much worse from people who should know better.)

Re:Mindsets to Avoid as a Senior Software Developer by spaetzleesser on Tuesday March 02, 2021 @01:54PM (#26318916)
“Moreover, people are busy and when they do code reviews, they are mostly looking for easy stuff to pick at. L

That’s a real problem. Almost nobody has the time to really understand the code they are reading and how it fits in.

Re:Mindsets to Avoid as a Senior Software Developer by bowlich on Tuesday March 02, 2021 @12:53PM (#26318104)
Conversely if you do attempt to do a deeper dive into the design and architecture choices my experience has been you end up getting push back and overruled -- because people are busy and don't want to miss a deadline with code that "works"/ passes whatever the minimum bar was set to hurl it into production.
Re:Mindsets to Avoid as a Senior Software Developer by vbtemp on Tuesday March 02, 2021 @01:17PM (#26318438)
I completely agree. The irony for me has been how immensely helpful toolchains (PRs, awesome unit test harnesses, powerful CI systems, etc etc) actually kind of make things worse and support everyone missing the forest for the trees.

Everything has become dislocated from reality. "Issues" and "tickets" does not capture actual work to do. Unit tests and CI do not capture whether something is truly functional. Peer-reviews do not mean a given commit is stronger than otherwise... At the end of the day there's just no replacement for good judgment and experience, despite all the fancy tools that want to try to "gamify" it.

Re:Mindsets to Avoid as a Senior Software Developer by nitrogen on Tuesday March 02, 2021 @10:49AM (#26316514)
As an opportunity to learn how to read and maintain the code that is being written, and to spot random mistakes that slip past the linter that everyone makes once in a while, yes. In that sense everyone should participate in code review.

But if you are giving veto power over code and designs to your most inexperienced developers, you will not have a good time.

Re:Mindsets to Avoid as a Senior Software Developer by Gh0stRAT on Tuesday March 02, 2021 @01:39PM (#26318722)
Early in my career, I learned so much from reviewing other more senior peoples' code.

I suppose I technically did have "veto power" as my approval was required in order to merge the PR, but nobody ever thought of it in such adversarial terms. We'd comment with questions or things that were unclear, occasionally asking "why are we doing it this way instead of that way?" and more often than not the solution was simply adding/updating comments to make things more clear.

For our team at least, it was a casual and collaborative effort where everyone learned from each other. I wouldn't hesitate to give inexperienced devs veto power over my PRs again unless it was for a time-sensitive hot-fix.

Re:Mindsets to Avoid as a Senior Software Developer by aequitas on Tuesday March 02, 2021 @10:57AM (#26316621)
Mileage may vary and it depends on the direct impact an approved review has (ie: is it CD to production or are there other quality gatekeepers), but giving junior members this responsibility can greatly help them in personal growth. They can always ask for a co-review if they think they are not able to make a decision, which itself can be another learning moment. And you don't have to tell them you secretly also review the code before it is pushed to prod ;).
Re:Mindsets to Avoid as a Senior Software Developer by Nursie on Tuesday March 02, 2021 @12:06PM (#26317500)
> even your senior code.

Especially your senior code, by the time you get to being an experienced engineer you really should appreciate the value of lots of eyes on your work.

You may indeed have written the greatest opus magnum of your programming career, but I bet there are a few little bugs or edge cases or something you've overlooked. There's always something.

Re:Mindsets to Avoid as a Senior Software Developer by eithed on Tuesday March 02, 2021 @12:57PM (#26318158)
I strongly disagree - while juniors are more than welcome to look at the PRs, if you allow juniors to approve PRs of other juniors you quickly find your codebase deteriorating.
Re:Mindsets to Avoid as a Senior Software Developer by apengwin on Tuesday March 02, 2021 @01:12PM (#26318359)
That's not what they're saying. Srs. should still review jr. PRs. They're arguing that Jrs should also review Sr. PRs
Re:Mindsets to Avoid as a Senior Software Developer by eithed on Tuesday March 02, 2021 @01:31PM (#26318631)
Well, if you'll allow everybody to review everybody PRs then eventually that's what you'll get.

Similarly - junior might look at your PR and see that it's ok. Senior might look at it, see that you've forgot about a thing that junior didn't know about, you omitted to test a certain condition, etc.

Again, juniors are more than welcome to look at PRs and be a part of discussion, but if you're merging, you should be wary. I'd personally be against allowing a merge if you get only a junior approval.

Re:Mindsets to Avoid as a Senior Software Developer by CodeMage on Tuesday March 02, 2021 @01:49PM (#26318849)
> Well, if you'll allow everybody to review everybody PRs then eventually that's what you'll get.

If you allow everybody to review every PR, it doesn't imply that you'll allow everybody to approve every PR.

Re:Mindsets to Avoid as a Senior Software Developer by lowbloodsugar on Tuesday March 02, 2021 @01:44PM (#26318782)
The difference is "approve" vs "criteria for merging". We have a system that requires two approvals, but one must be from a list of seniors (which doesn't include new hires).
Re:Mindsets to Avoid as a Senior Software Developer by eithed on Tuesday March 02, 2021 @02:11PM (#26319120)
Mhm - if you'll separate your review process from approval process, then yes.
Re:Mindsets to Avoid as a Senior Software Developer by taylodl on Tuesday March 02, 2021 @01:47PM (#26318838)
I've found code reviews to be a waste of time. Here's my primary concern: what evidence do you have that this code actually works? I want you to show me your test plan, I want you to show me you thought through how this code is going to be used and have tests for it. I'm way more interested in that than I am whether variable names use camel case or snake case or whatever. In fact if your tests are complete, and pass, then we can always refactor the code later if we need to.
Re:Mindsets to Avoid as a Senior Software Developer by jaxwerk on Tuesday March 02, 2021 @02:10PM (#26319096)
> Here's my primary concern: what evidence do you have that this code actually works?

This is a strange concern to try to address with code-review. I don't think most folks actually expect to catch a lot of bugs by staring at diffs. Testing is the right tool for that job.

> I'm way more interested in that than I am whether variable names use camel case or snake case or whatever.

Style concerns definitely shouldn't be the primary focus of a code review. Ensuring some stylistic consistency through the code base is a benefit they can provide, but certainly not the the most major.

> In fact if your tests are complete

How do you know if the tests are complete on someone's work before they merge it? Don't you need to get in there, and well, review their code to see what tests they wrote? Evaluation of test coverage by a peer is one of the more important parts of a good code review. What other process would you use to ensure incoming patches have the test coverage you want them to have?

> we can always refactor the code later if we need to.

Isn't it better to catch code structure issues when they are fresh in everyone's mind rather than taking on technical debt and addressing it down the road when it will require more effort? We've all written code in somewhat silly ways. My experience is that when a peer calls that out before I merge it, it's way easier to fix up-front than a year down the road when I'm in there trying to fix some bug and am wondering if I should just refactor the mess while I'm at it.

Re:Mindsets to Avoid as a Senior Software Developer by taylodl on Tuesday March 02, 2021 @02:57PM (#26319751)
> This is a strange concern to try to address with code-review. I don't think most folks actually expect to catch a lot of bugs by staring at diffs. Testing is the right tool for that job.

Correct. I expect those tests to be developed alongside the code. Part of my 'definition of done' is you have passing tests to prove the implementation is complete.

> Style concerns definitely shouldn't be the primary focus of a code review. Ensuring some stylistic consistency through the code base is a benefit they can provide, but certainly not the the most major.

Agreed. However, I've seen too many toxic scenarios where this is what actually happens.

> How do you know if the tests are complete on someone's work before they merge it?

Everything at the branch point can be tested. Also, since we have tests, we have the ability to regression test and ensure everything is still working properly after the merge.

> Isn't it better to catch code structure issues when they are fresh in everyone's mind rather than taking on technical debt and addressing it down the road when it will require more effort?

Yes. My counterargument though is having a complete set of tests that all pass is far more important than concerning yourself with the structure of the code. I understand that's a radical departure from the state of the art but it stems from years and years and years, nay decades, of enduring counterproductive code reviews. I've sat in on several sessions where there have been long, drawn-out discussions on flexibility and extensibility when 9 times out of 10 it simply didn't matter. I've seen so much time wasted on stuff that ultimately didn't matter.

My take away: make sure your tests are reasonably complete and they pass. If so then you're good. Maybe take a quick look at the code, especially if being submitted by a junior, to make sure nothing outrageous is present, otherwise don't worry too much about it.

Re:Mindsets to Avoid as a Senior Software Developer by aequitas on Tuesday March 02, 2021 @02:12PM (#26319124)
Bingo. If your function is properly tested or your _intent_ is properly documented/commented I don't care how the code looks (to a degree), as long as I have all the information I need to refactor it right there.

Also reviewers shouldn't squabble about syntax or formatting, that what we got computers for to do for us using auto formatting tools. Though it does help if a team converges on a similar style for which reviews are great as you quickly learn each others style and cross contaminate them with your own.

Re:Mindsets to Avoid as a Senior Software Developer by dm03514 on Tuesday March 02, 2021 @01:57PM (#26318941)
I have the same mentality. I feel like almost everything is an implementation detail. Every person's implementation is likely to be different. In my experiences, even the poorest code is maleable (i.e. software :p).

PR's become more of a gate to see if you understand the problem and test for the solution opposed to HOW you went about it. Maybe I've had bad experiences but focusing on HOW is really prone to toxicity. I try to avoid that in PRs at all cost and foster a culture of collaboration, shared understanding of the PROBLEM and Respect for the Constraints. I've left places because of extremely toxic PR culture, so I'm probably pretty jaded :p (The culture was so bad I dreaded asking for reviews.)

How did you prove that your solution works and respects the constraints?? How do you protect yourself and others from future changes? Everything else is an implementation detail.

Re:Mindsets to Avoid as a Senior Software Developer by spaetzleesser on Tuesday March 02, 2021 @01:52PM (#26318887)
I often find stuff and also get suggestions for things that could have been done better. I view code reviews more as a mutual learning experience similar to pair programming. Checking for variable names is silly.
Re:Mindsets to Avoid as a Senior Software Developer by aequitas on Tuesday March 02, 2021 @02:40PM (#26319525)
When I stopped seeing code reviews as gate keepers and started seeing them as collaboration and communication points it finally made sense to me. But reviews only work well if your team shares a common goal, like maintainability or knowledge transfer.

I've worked in a place where code reviews where treated to just a box to have checked off. There was no shared responsibility for the codebase. And most people had a mentality of "if you approve mine, I'll approve yours". Still it was kept as a "safeguard" by management because for them it was also a checkbox they could mark on their process checklist. I'm happy I left, there is only so much culture a single person can change in a team/company.

Re:Mindsets to Avoid as a Senior Software Developer by dougmwne on Tuesday March 02, 2021 @01:56PM (#26318928)
In QA I have found a code review to be very helpful in identifying test cases. Often I'll think I've covered every edge case I can think of, but once I've read through the code I identify the implementation can fail in a certin scenario I hadn't considered. This is why I think Black Box testing is a bad approach unless something about the circumstance specifically calls for it. I do think it's better to have a test plan first, then supplement it with code review, just to not get overly biased.
Re:Mindsets to Avoid as a Senior Software Developer by mathgladiator on Tuesday March 02, 2021 @01:51PM (#26318877)
This all depends on your dev environment; a code review should also have tests with the diff as well as test results, and the more automated the better.
Re:Mindsets to Avoid as a Senior Software Developer by thinkingkong on Tuesday March 02, 2021 @10:56AM (#26316612)
You need to redefine success if you think that’s failure. The software is almost by definition not a magnum opus if it isnt understandable or well documented. This attitude is somewhat pervasive but we really need to set better examples through clarity; not cleverness.
Re:Mindsets to Avoid as a Senior Software Developer by hinkley on Tuesday March 02, 2021 @12:20PM (#26317703)
Everyone is the hero in their own story.
Re:Mindsets to Avoid as a Senior Software Developer by _throwawayyyyyy on Tuesday March 02, 2021 @01:32PM (#26318633)
exactly - was on a team where an individual contributor got promoted vertically to manager and thought they could create a good product by code reviewing everyone to death and demanding that they be the only one allowed to code review. no more tagging other teammates; just this manager