So first off a personal update – last year, I got laid off the day I returned from maternity leave! Within a half hour of returning to my desk! Whew boy! It was a blessing in disguise in some ways, because 1) I’d been thinking for some time I could be more effective in a consulting role and 2) as part of my severance package, I got to attend a General Assembly coding bootcamp.
I ended up auditing the bootcamp because wow, it demands a ton of sacrifice with the end goal of getting a developer job. In contrast, I am happy to do a bit of scripting on the side, work with developers, and improve their experiences. Nonetheless, I worked through all the lectures, did a few homework assignments, and got a lot out of it. Not the least of which is that I validated my existing coding skills, gained deeper insight into the “junior developer” persona, and reaffirmed my conviction that tailoring your developer experience and docs to junior developers is a Good Thing.
There are a couple of big takeaways I’d like to share:
Everyone is a junior developer
Well, no, not actually … but every developer has to learn new concepts. And yes, of course, as you gain experience as a developer, “totally new” concepts get rarer and rarer. Still, there’s a lot of learning:
I felt I experienced this disruption myself as part of the coding bootcamp. Up till then, my background was in writing Python scripts, and in documenting big Java applications in a analytics microservices context. I knew about RedHat, Docker, Kubernetes, Spark, Lucene, Cassandra, etc.
Which brings me to my main point:
We should all design for the junior developer
Creating experiences with a junior developer in mind forces you to discard your comfy assumption that everyone’s drunk your product Kool-aid. If you assume you’re writing for someone who’s technically savvy and can learn quickly, but who knows nothing about your world, you’re positioning yourself to vastly decrease your developer onboarding friction. And if you assume that your “junior developer” is super impatient because they have, like, 10 other things on the docket to learn about, then you’ll learn to answer up front the question: “why should I care? Why should I do this work?”
It’s a fine line to tread, assuming not too much about technical knowledge, but also not coming across as condescending or silly (like, at the level of “open a terminal by taking the following steps…”). Still, I think it’s actually quite achievable. For example, it’s quite low effort to provide high-level context for coding instructions. Even something as simple as “Clone this repository and open a terminal at the local directory location” is a direction that often gets left out in GitHub readmes…but it really shouldn’t be left out. And it never hurts to link to frameworks’ getting started guides, even if you don’t want to provide the details yourself. At the very least, no one is likely to roll their eyes at it, and it helps your reader understand what level of granularity your instructions will provide.
When I look for inspiration, I think the React newbie tutorials do an outstanding job of introducing junior developers to React, helping them understand why they should care, and explicitly stating their audience. I also really love (who doesn’t) the Stripe developer onboarding experience.
Ultimately, I think I came away from the coding bootcamp more confident that I am a junior developer. And while I’d never make the classic UX mistake of thinking I am the user, still – my confusions, my pain points in learning about a product– these are things that other developers likely share.
I’ll end on another personal note. The coding bootcamp turned out to be quite serendipitous, because I took on contracting work that immediately benefited from my new knowledge. I’d just learned about Express, and now here I was, entering a pull request to change the authentication method for an Express server. I’d just learned about React, and now here I was, wading into a web UI to change some text. It’s always nice when you can put what you’ve learned to immediate use.