Just watched this short course before work today, and found it very relevant. I'm a veteran developer. I'd like more content and wisdom on how to have the confidence to ask questions so I can onboard effectively when there is a steep power imbalance. I'm feeling pretty exposed in a new position as the information I need to get a solid foundation is not readily available, and my leaders technical writing is so brief as to be unusable for new starters (its expert writing for experts, not expert writing for the less knowledgable).
I know you said if you went into more detail it would be 20 hours, but seriously, that would be extremely valuable content for me.
The difference between a great place to work and a mediocre place to work is often the quality and willingness to of colleagues both senior and junior to communicate and share. The worst places are when colleagues on the same team don't really work together on problems and only communicate through PRs. Such feedback is too late IMHO and leads to waste and low motivation.
I would suggest:
More tips:
While this is something that have worked for me, I'm always open to feedback from the community
I'm so glad you liked the course - I'm literally working on an incredibly in-depth course about how to ask questions effectively right now!
When it comes to crappy technical writing and documentation, my advice is to be the change you want to see. In general, I initially assume good intent: A lot of folks have bad, esoteric technical writing and communication because they don't know any better (and it is very easy to be in an ivory tower and not realize it). Do your best to set the example with stellar technical writing of your own and hope that spreads.
One thing I will say though is that documentation in particular is often bad at top tech companies by design (so many wikis at Meta were outdated and messy). At a top company, the codebase will change lightning fast so it's unsustainable to keep wikis explaining how it works up to date.
The ideal "antidote" to bad documentation is to do the organic thing and talk to your teammates. Onboarding engineers should have ample 1 on 1s and strive to build trust fast: [Masterclass] How To Build Deep Relationships Quickly In Tech