About this Post

Spent some time contributing to Vercel and Next.js 12.1 docs.


I'm a big fan of Vercel and Next.js, as well as the people behind them (going back to their earlier years). Since I'm also a maintainer of the Tesla Next.js scaffold — a starter kit of the sorts to help teams easily bootstrap their web apps with our Tesla Design System — I thought I'd review and attempt to contribute to Vercel's documentation, based on some inclusive naming conventions we're advocating for.

Next.js 12.1: ◆ On-demand Incremental Static Regeneration ◆ SWC support for styled-components, Relay, and more ◆ Zero-configuration Jest support ◆ ~80% smaller Docker images when self-hosting ◆ Next.js Developer Survey
Loading...

Along with wrangling pixels and code at Tesla, I try to create an inclusive workplace, both in person and online. I'm on the Tesla Naming Conventions working group. Starting with systems, code, and the like, this working group is working toward helping standardize naming across the company to be more inclusive. Also, I'm a leader in the Tesla JavaScript working group, aimed at standardizing and JavaScript (and related) solutions, at-scale, to teams across the company.

Earlier this month I contributed to the @vercel->@nextjs codebase. The team made the experience super low-friction. Part of the contribution: further deprecation of the usage & reference of the "master" terminology in their docs & repo branches 💯 #TechIsNotNeutral #inclusion
Loading...

In short, the contributor process was easy peasy, lemon squeezy.

I read through the Vercel and Next.js websites, and found a few things that could be improved. I made PRs here and here, and they were merged after a relatively quick review by the maintainers. The changes eventually made their way into the Next.js 12.1 release.

While I was at it, I also made a PR to the SWR docs. Similarly, it was reviewed, approved and merged relatively quickly.

The Vercel crew is awesome. I'm glad I could contribute to their docs. I'm also glad the experience of contributing was so easy and welcoming by the team. I'm looking forward to contributing more in the future.