News for hackers. Stuff that matters.
Re:How to mentor software engineers by pkdpic_y9k on Tuesday January 04, 2022 @12:24PM (#29797276)
One thing I sometimes point out to software engineers Im tasked with mentoring at work is the importance of showing other engineers that you care about the code and the questions you're asking via slack etc by proof reading what you write and reviewing your own code before reaching out to others for help. The frustration of reading ia garbled slack message or pulling over to look at a code snippet and realizing the person didn't even look over it themselves is real and has real negative consequences in terms of professional perception.

Like when someone misspells radical candor in the second sentence of a blog post about mentoring.

Seriously though, everybody makes mistakes but when I do slip up like this I don't expect people to engage with what I'm writing. And I do think proof reading is an incredibly important skill for new and experienced software engineers.

[edit] I just noticed the author is a staff engineer at MongoDB. He can misspell whatever he wants. I recant my sassiness.

Re:How to mentor software engineers by xdg on Tuesday January 04, 2022 @01:00PM (#29797754)
Thanks! Fixed. We're all human. :-)

And now I've discovered that vim spell check skips words with leading markdown symbols like `*randical`. I'll have to dig into that more.

Update: pasting the web page to Google Docs found a few more typos. I fixed those, too. Usually I print and read to find typos, maybe I skipped that this time. Good reminder to do that and the Gdocs review. Really: thanks for the reminder, regardless of the sassiness. :-)

Re:How to mentor software engineers by pkdpic on Tuesday January 04, 2022 @03:04PM (#29799552)
[posting from my primary account]

I really am sorry for being a troll and writing the kind of comment that bums me out on a regular basis. This seems like a good post and a good discussion.

It can just be frustrating for those of us that have a hard time getting traction when we post projects etc on sites like HN. It can manifest into petty toxic behavior especially in comment sections.

In the words of Paul Doherty... "I'll do better next time."

Re:How to mentor software engineers by ecnahc515 on Tuesday January 04, 2022 @03:10PM (#29799645)
You may have just finally explained why I frequently find spelling mistakes and using vim's spell check. Thanks for the tip!
Re:How to mentor software engineers by Forricide on Tuesday January 04, 2022 @04:42PM (#29800966)
> And now I've discovered that vim spell check skips words with leading markdown symbols like `*randical`. I'll have to dig into that more.

Taking a quick look, for me it seems that (Neo)Vim spell check skips anything in italics or bold. No highlights whatsoever anywhere in that region. Definitely not something you want to realize _after_ publishing articles!

Edit: Considering the comment about using :syn off, seems like this is probably a conflict of some kind with the way Vim actually italicizes/bolds things in terminals that support it, now.

Re:How to mentor software engineers by CodeIsTheEnd on Tuesday January 04, 2022 @02:26PM (#29798929)
Anything longer than a few sentences I'll write in vim and am always horrified when I copy to Gmail or Google docs and find spelling mistakes, duplicated words, and incomplete sentences everywhere.
Re:How to mentor software engineers by tiddles on Tuesday January 04, 2022 @03:56PM (#29800361)
Aspell is a good interactive spell checker for just before publishing.

‘aspell -c text.md’

Re:How to mentor software engineers by xdg on Tuesday January 04, 2022 @04:57PM (#29801149)
Thank you! I just checked and it does not ignore markdown prefixed words.

Also, I found that `:syn off` gets vim to spell check within markdown formatting.

Re:How to mentor software engineers by xupybd on Tuesday January 04, 2022 @01:46PM (#29798395)
Some rush and are sloppy.

Some are burnt out and unable to focus.

Some have dyslexia and are trying harder than you'll ever know to proof read.

Re:How to mentor software engineers by xyzzy_plugh on Tuesday January 04, 2022 @02:29PM (#29798970)
I agree, but you can generally differentiate these cases and handle them appropriately.

If someone is burnt out, the attitude is typically the tell regardless of care. It's deliberately sloppy.

One of the best engineers I ever worked with had dyslexia and by God if his class names weren't the funniest things I've ever seen, but they were consistent and the structure and documentation was thoughtful.

Re:How to mentor software engineers by creativenolo on Tuesday January 04, 2022 @06:43PM (#29802653)
#3 so much. Still always garbled.
Re:How to mentor software engineers by royaltjames on Tuesday January 04, 2022 @03:19PM (#29799813)
Ironic that you pointed out an error in blog post's 2nd sentence when you also have one in your 2nd sentence. Either that or a nag trap. Or an unconscious parallel humility.
Re:How to mentor software engineers by Stratoscope on Tuesday January 04, 2022 @03:35PM (#29800059)
Or an example of Muphry's Law.

https://en.wikipedia.org/wiki/Muphry's_Law

Re:How to mentor software engineers by selljamhere on Tuesday January 04, 2022 @12:45PM (#29797542)
I usually have a knee-jerk reaction when I see grammar and spelling errors in blogs, but I try to remind myself that these posts aren't published works that made it through an editorial staff. Mistakes happen, especially when the author isn't a professional writer.
Re:How to mentor software engineers by pc86 on Tuesday January 04, 2022 @01:00PM (#29797744)
This is all true of course, but is it really so much to expect someone to proof-read something they're publishing? All things being equal, more of these types of simple-to-catch errors will make people think less of your [skill, dedication, attention to detail, etc.], whether right or wrong.
Re:How to mentor software engineers by bonestamp2 on Tuesday January 04, 2022 @01:47PM (#29798405)
I ran a very popular site for a decade and won multiple writing awards. There are many elements that make a well written piece, and of course, spelling and grammar are two important ones.

Unfortunately, over 12 years, I had two spelling mistakes slip through my hours of editing and proofreading. Some people absolutely eviscerated me for it. I mean, how could I not know how to spell X word? I must be a moron! In my opinion, these "simple-to-catch" errors are not always simple-to-catch when the writer knows what it is supposed to say and they are trying to proofread their own work.

That said, it proves you're right -- people do think less of you when you make such a mistake. I think we should all strive to cut people a little more slack, at least on Slack.

Re:How to mentor software engineers by pkdpic_y9k on Tuesday January 04, 2022 @12:54PM (#29797646)
I agree, the guys clearly legit. I was just indulging some recreational morning pedantry before actually getting some work done.
Re:How to mentor software engineers by organsnyder on Tuesday January 04, 2022 @12:56PM (#29797689)
I wouldn't normally point this out, but you're missing an apostrophe (should be "guy's"). Good example of Muphry's Law.
Re:How to mentor software engineers by d3ckard on Tuesday January 04, 2022 @01:04PM (#29797787)
You mean Murphy’s Law, perhaps?
Re:How to mentor software engineers by organsnyder on Tuesday January 04, 2022 @01:42PM (#29798331)
Re:How to mentor software engineers by flakiness on Tuesday January 04, 2022 @12:48PM (#29797578)
I don't think adding a jerk-ish edit helps you sounding a engaging and/or caring mentor although I admit that I was almost bursting out. Being consistent is hard, but let's try within the same <textarea>.
Re:How to mentor software engineers by pkdpic_y9k on Tuesday January 04, 2022 @12:51PM (#29797612)
I mean it, he's a more accomplished engineer and mentor than I'll ever be. That's why I added the edit.
Re:How to mentor software engineers by flakiness on Tuesday January 04, 2022 @05:30PM (#29801649)
All right, So I'm more cynical than I was aware of :-)
Re:How to mentor software engineers by dd444fgdfg on Tuesday January 04, 2022 @04:53PM (#29801091)
I'm*