But I fully agree that for juniors it makes sense to have it mandatory.
Asking questions on code reviews is one of the most powerful tools to learn more about a codebase, and fostering a culture where junior devs feel empowered to ask questions is one of the best ways to help junior devs succeed.
1. An odd business requirement (share the origin story)
2. It took research (summarize with links)
3. Multiple options were considered (justify decision)
4. Question in a code review (answer in a comment)
Important caveat for number 4: if your code can be restructured in a way that answers the question without a comment, do that instead.
This originally comes from an article[1] I wrote in 2021 titled "Writing Maintainable Code is a Communication Skill".
It's kind of like some of the existing reasons, but there is a difference there.
000ooo000•1mo ago
sublinear•1mo ago
Yeah that's very clearly an ad. They didn't even try to be subtle lol.
AntonZ234•1mo ago
alienbaby•1mo ago
tzs•1mo ago
This is good. This is the kind of advertising that people here usually say that sites should be using if they need ads.
000ooo000•1mo ago
tzs•1mo ago
For example "Chess Life" mostly contains ads that are irrelevant to everything other than chess. "QST", a ham radio magazine, mostly contains ads that are irrelevant outside of ham radio.
This is what I most often see people here suggesting as the right model for internet advertising.
AntonZ234•1mo ago
OP here. I actually feel that having ads that are relevant to the people reading are better both ways, as you might actually learn about a good tool :) (I try at least to only work with products I believe in).
I felt that having the ad between line dividers, and having this: "Thanks Linear for supporting today’s article!"
should be enough, but maybe I'm mistaken.
tzs•1mo ago
AntonZ234•1mo ago