Refactoring

Refactoring

Share this post

Refactoring
Refactoring
Nailing your your Onboarding Developer Experience ๐ŸŽ’
Copy link
Facebook
Email
Notes
More

Nailing your your Onboarding Developer Experience ๐ŸŽ’

A guest article by Dana Lawson

Luca Rossi's avatar
Dana Lawson's avatar
Luca Rossi
and
Dana Lawson
Feb 26, 2025
โˆ™ Paid
28

Share this post

Refactoring
Refactoring
Nailing your your Onboarding Developer Experience ๐ŸŽ’
Copy link
Facebook
Email
Notes
More
Share
Upgrade to paid to play voiceover

Hey there! Last week we started our three-part series on how to hire engineers, talking about my favorite hiring principles.

Hiring Principles for Engineering Teams โœจ

Hiring Principles for Engineering Teams โœจ

Luca Rossi
ยท
Feb 19
Read full story

As a recap, they are:

  1. ๐Ÿš€ Hire as a last resort โ€” address systemic issues and improve productivity before adding headcount.

  2. ๐Ÿ”„ Balance team composition โ€” mix junior and senior roles to improve processes, optimize costs, and match work to experience so that everyone is always challenged, regardless of their level.

  3. ๐ŸŽจ Embrace diversity โ€” build teams that reflect your user base to enhance decision-making and product quality.

So, this week I am bringing in my friend Dana Lawson to continue the conversation and explore the developer experience of hiring, from first touch to onboarding, and why this matters to your company culture. Dana is CTO at Netlify and former VP of Engineering at Github, so she knows a thing or two about developer experience!

Finally, next week we will close the loop with a deep dive into how to interview engineers, with plenty of examples and real-world stories from the community.



Hey, Dana here! A tale as old as time โ€” how do you find the right people to join your journey, and how do you allow them to add immediate impact to your business and culture?

In this article we are going to cover how you can supercharge the developer experience of your hiring process โ€” from your job description all the way through to the first production ship of your new hires! ๐Ÿšข

Here is what we will cover:

  • ๐Ÿ“‹ Job description โ€” what your job description says about your company, your culture, and what to expect from your future engineers. Letโ€™s wow them before they even apply!

  • ๐ŸŽ’ Onboarding โ€” how to enable new hires drive impact in the first week and how to speed-run building workplace relationships.

  • โš’๏ธ Tooling โ€” how to apply an engineering mindset to onboarding and codify the process to help your engineers ship in week one!

  • ๐Ÿ“Š Metrics โ€” Hiring cycle time, onboarding goals, and following up for sentiment with surveys and check-ins.

Letโ€™s dive in!


๐Ÿ“‹ Job Description

The time has come โ€” your headcount has been approved and now you need to post the job listing.

Even if you already have a template or framework, you should always revisit the descriptions: the company changes, roles morph, and like any good process you should always refresh.

Now, your job description is your first opportunity to excite your potential new engineers: it sets the tone for the company culture and how they will contribute to the mission. The importance of this is hard to overstate โ€” many times I have seen the wrong candidates come in or, even worse, you are almost through with the hiring process and misalignment arises on expectations about the role or company. This is particularly harmful because, as we know, hiring is a long and expensive process ๐Ÿ‘‡

In the internet and tech industry in the US, the average length of the interview process is approximately 24 days, while the recruitment process for a software engineer in the US usually spans about 35 days. It has been observed that filling a senior application developer's position typically takes around 20% longer (28.3 days) compared to a web application developer (23.5 days).

So, a great job description helps you 1) draw in the right engineers, and 2) set them up for success from the first touch. The way you demonstrate the values and principles of your culture through this posting is a great way to start off a positive engagement before you even have spoken to the future team member.

Aside from the standard HR and Legalese that is required for the posting, you should focus on two things:

  1. ๐Ÿ”ฅ Excitement โ€” driving the excitement about the opportunity.

  2. ๐Ÿ† Success โ€” explaining what success looks like in the role.

Letโ€™s look at both!

1) ๐Ÿ”ฅ Excitement

To drive excitement, spend time on your opening statement: figure out what the elevator pitch of the role and team is, and why the person reading this post is going to have a great experience.

Keep it simple, keep it accurate, and add some character! You donโ€™t need to write a novel, but you do want to appeal to the right candidate/engineer, so make sure you are not only describing the job but, more importantly, what are you looking to add to the team, plus a little about who you are.

Consider this initial pitch from the job description as your intro to your candidate, and practice some role-playing with your talent partner if they do sourcing or first touch โ€” they play a critical role in the hiring journey so treat them as an extended representation of your engineering team.

2) ๐Ÿ† Success

Next letโ€™s talk about success. Success is a tricky area, as you want to be broad, but also specific:

  • โ†•๏ธ Be specific โ€” about the day-to-day responsibilities, ceremonies and rituals of the team and role. Ensure if you are remote that you talk about how you are expected to collaborate and participate. If you need deep technical skills in an area, call that out.

  • โ†”๏ธ Be broad โ€” on the areas that people can continue to hone their skills against to demonstrate the opportunity for professional development. This area of the job description should be the closing statement to demonstrate a peak into your career levels.

Here is a quick and easy template to use:

  1. ๐Ÿข Why [Your Company] โ€” a brief mission statement.

  2. ๐ŸŽฝ Why [Your Team] โ€” elevator pitch with personality.

  3. ๐ŸŒŸ Core values โ€”highlight your guiding principles.

  4. ๐Ÿ‘‘ Key responsibilities โ€” clear expectations.

  5. ๐ŸŽ“ Required skills โ€” ensure alignment with career levels.

  6. ๐ŸŽ Benefits โ€” comprehensive package details.

Finally, here are some great examples of how a good job description can tell a story:

  • ๐Ÿ“‘ Backend Engineer at GitLab

  • ๐Ÿ“‘ Senior Infrastructure SRE at Netlify

Next, time to discuss onboarding ๐Ÿ‘‡


๐ŸŽ’ Onboarding

This post is for paid subscribers

Already a paid subscriber? Sign in
ยฉ 2025 Refactoring ETS
Privacy โˆ™ Terms โˆ™ Collection notice
Start writingGet the app
Substack is the home for great culture

Share

Copy link
Facebook
Email
Notes
More