Alumnus of dev.to, the Rust Foundation, RustConf, & the Linux Foundation 🌐 | Writer, teller, & amplifier of authentic open source stories 📚 | Avid gardener 🌱
- Former DEV/Forem team member <3
Location
Portland, Oregon
Education
Comparative Literature & the History of Ideas @ Willamette University
Hi Nathan — this is great! Would you consider sending us a voice recording of this comment and/or other thoughts and suggestions on onboarding devs? Instructions to submit a recording are above.
We love to feature actual voices from the community on DevDiscuss 🌟
Don't be a dick. And being a "nice asshole" (backhanded, passive aggressive, etc.) doesn't count as not being a dick.
Don't make assumptions, about what they know or what they don't know.
Should be a duh, but usually isn't (relates to point 2): Good documentation AND discussion is a must. You may think your code is self-evident, but they haven't been working on this project for months or years like you have.
Not nearly enough people do this: Architect with the junior developer in mind. It doesn't matter what your project accomplishes or aims to accomplish. It should be simple enough for a junior dev to quickly get up to speed to add or make modifications to the project as they learn (relates to point 3, but specifically addressing the code/infra here).
Passionate developer in Java and Scala. And sometimes, something else. A few months per year, someone calls me "professor". CoFounder of Scala By The Lagoon @scalagoon
Onboarding starts before "getting on board": thinking about new dev onboarding (also known as "thinking about team scalability and resilience") means having:
general/product goal/architecture documentation well laid out and kept fresh
clear processes for HR (first), and commit/push/test/CI/collaboration/release (better if automated)
and a practice of reaching out and speaking about how the organization works and how it pursues its goal of attracting talent and doing good business.
If you have this in place, then onboarding is really easy, and adding hands to the team is no more hassle than picking the right personality and some familiarity with the tools.
Oh, and all that will be beneficial all around, so making onboarding easier is just icing on the cake.
Alumnus of dev.to, the Rust Foundation, RustConf, & the Linux Foundation 🌐 | Writer, teller, & amplifier of authentic open source stories 📚 | Avid gardener 🌱
- Former DEV/Forem team member <3
Location
Portland, Oregon
Education
Comparative Literature & the History of Ideas @ Willamette University
Hi Helen! We'd love to feature your voice on this episode of DevDiscuss! Would you consider sending us a voice recording summing up your thoughts on onboarding new devs? Instructions to do that are above 🙂
I think the goal of onboarding is to provide context. Any dev coming onto a new project doesn't know the history of the project, the decisions made, or the architecture. A good onboarding will provide info on all of these.
The actual process could vary depending on the level of the developer. A senior developer may be fine with a few diagrams and documentation. But an early in career developer might need some more hands on onboarding e.g. through pairing or knowledge sharing. The onboarding process should accommodate both of these options!
Good onboarding experiences for me have been:
Onboarding steps documented and up to date.
Automating things like permissions to projects.
Culture doc for things like meeting expectations, fun events, or slack channels to join.
Finally, a good onboarding process should have continual check in's. Either through an onboarding buddy or through your team. When I first started as a developer, I didn't ask questions because I was worried about disrupting others. This caused me lots of pain and slowed down my onboarding.
Making a safe space for someone onboarding to ask questions is really important. And we want to give developers the time to soak in all the new information.
I only have experience with very small, early-stage teams, and in terms of technical onboarding I really liked the process I went through.
The README contained all the information I needed to set up my local environment
If there was anything missing, I could ask a colleague for help, and add the missing info to the README. This was also my first commit and contribution to be merged, which gave the nice feeling of a quick first win, and improved the README for future onboarding.
In my experience, I would argue that the most important onboarding work is done by actively maintaining your project documentation.
There have been too many cases where little inconsistencies or additional steps are added throughout the development process that quickly turn onboarding into a minefield for new hires.
Pairing with other people in the team, updating the onboarding documentation as they go over setting things up and reviewing things with the new developer.
Alumnus of dev.to, the Rust Foundation, RustConf, & the Linux Foundation 🌐 | Writer, teller, & amplifier of authentic open source stories 📚 | Avid gardener 🌱
- Former DEV/Forem team member <3
Location
Portland, Oregon
Education
Comparative Literature & the History of Ideas @ Willamette University
Alumnus of dev.to, the Rust Foundation, RustConf, & the Linux Foundation 🌐 | Writer, teller, & amplifier of authentic open source stories 📚 | Avid gardener 🌱
- Former DEV/Forem team member <3
Location
Portland, Oregon
Education
Comparative Literature & the History of Ideas @ Willamette University
Pairing, pairing, and a little more pairing.
It naturally provides opportunities for them to learn:
on the team(s) that the onboardee needs to know.
Hi Nathan — this is great! Would you consider sending us a voice recording of this comment and/or other thoughts and suggestions on onboarding devs? Instructions to submit a recording are above.
We love to feature actual voices from the community on DevDiscuss 🌟
I've worked in very small and very big companies with different approaches to onboarding, here's a list of what a great one should have IMO:
Onboarding starts before "getting on board": thinking about new dev onboarding (also known as "thinking about team scalability and resilience") means having:
If you have this in place, then onboarding is really easy, and adding hands to the team is no more hassle than picking the right personality and some familiarity with the tools.
Oh, and all that will be beneficial all around, so making onboarding easier is just icing on the cake.
I have a lot of thoughts on this :D
Onboarding: How to give new hires a soft landing
Helen Anderson ・ Feb 10 ・ 5 min read
Hi Helen! We'd love to feature your voice on this episode of DevDiscuss! Would you consider sending us a voice recording summing up your thoughts on onboarding new devs? Instructions to do that are above 🙂
Done! Hope it fits the brief :)
I think the goal of onboarding is to provide context. Any dev coming onto a new project doesn't know the history of the project, the decisions made, or the architecture. A good onboarding will provide info on all of these.
The actual process could vary depending on the level of the developer. A senior developer may be fine with a few diagrams and documentation. But an early in career developer might need some more hands on onboarding e.g. through pairing or knowledge sharing. The onboarding process should accommodate both of these options!
Good onboarding experiences for me have been:
Finally, a good onboarding process should have continual check in's. Either through an onboarding buddy or through your team. When I first started as a developer, I didn't ask questions because I was worried about disrupting others. This caused me lots of pain and slowed down my onboarding.
Making a safe space for someone onboarding to ask questions is really important. And we want to give developers the time to soak in all the new information.
I only have experience with very small, early-stage teams, and in terms of technical onboarding I really liked the process I went through.
In my experience, I would argue that the most important onboarding work is done by actively maintaining your project documentation.
There have been too many cases where little inconsistencies or additional steps are added throughout the development process that quickly turn onboarding into a minefield for new hires.
Pairing with other people in the team, updating the onboarding documentation as they go over setting things up and reviewing things with the new developer.
For me mainly giving chances, I think with a good conversation instead of a "test" you can tell how someone is, if they are willing to learn.
So give them a chance to prove themselves.
Hi Greg! Thanks for these thoughts! Would you consider submitting this as a voice recording also? Instructions are above 🎧 🎧 🎧
woo hoo! Thank you :) 😊