Skip to content

Commit

Permalink
Sam's review
Browse files Browse the repository at this point in the history
  • Loading branch information
danilo-leal committed May 10, 2024
1 parent 982764c commit 8174aed
Show file tree
Hide file tree
Showing 2 changed files with 23 additions and 30 deletions.
2 changes: 1 addition & 1 deletion docs/pages/careers.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -155,7 +155,7 @@ const openRolesData = [
{
title: 'React Engineer — Docs Infra',
description:
'You will drive the development of the documentation platform that powers all MUI products, enabling it to grow and establish itself as a mature product.',
'You will drive the development and maintenance of the documentation platform that powers all MUI products.',
url: '/careers/react-engineer-docs-infra/',
},
],
Expand Down
51 changes: 22 additions & 29 deletions docs/pages/careers/react-engineer-docs-infra.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# React Engineer — Docs Infra

<p class="description">You will drive the development of the documentation platform that powers all MUI products, enabling it to grow and establish itself as a mature product.</p>
<p class="description">You will drive the development and maintenance of the documentation platform that powers all MUI products.</p>

## Details of the role

Expand All @@ -13,7 +13,7 @@

MUI's story began in 2014 with Material UI, the most successful React implementation of Google's Material Design.
Today, Material UI stands as one of the most popular open-source libraries on GitHub and has paved the way for the fully-fledged startup known as MUI (founded in 2019), which now boasts an ever-expanding ecosystem of React UI products.
We're a company of 31+ people as of late 2023, and we're growing.
We're a company of 35+ people as of early 2024, and we're growing.

## The products

Expand All @@ -25,7 +25,7 @@ Beyond the core libraries, MUI X offers advanced components like the Data Grid,

We're also making ambitious moves to incorporate our full suite of components into Toolpad, a low-code admin builder tool for assembling full-stack apps faster than ever.

Learn more about MUI's products in this blog post: [An introduction to the MUI ecosystem](https://mui.com/blog/mui-product-comparison/). (This is also the kind of content you might create!)
Learn more about MUI's products in this blog post: [An introduction to the MUI ecosystem](https://mui.com/blog/mui-product-comparison/).

## The culture

Expand All @@ -38,34 +38,30 @@ Learn more about what we value as an organization: [Evolving MUI's core values a

## Why we're hiring

Documentation is arguably one the most essential pieces of any of our products.
It's how developers learn about each corner of a given library, becoming empowered to bend them to the needs of their projects.
It also plays as an illustration of the principles we hold true to the product. It needs to be performative, fast, beautiful, and clear.
Documentation is critical to the overall experience of our products, and as one of the leading open-source UI projects, users expect our docs to be the best in class.
The docs are the primary means by which developers discover our products and learn how to wield them effectively.
And just like the products themselves, the documentation should reflect our fundamental priorities of performance, speed, beauty, and clarity.

Over the last two years, we have established an internal docs-infra team responsible for pushing the documentation platform forward, developing features such as automatically-generated OG images, multi-tab component demos, speed performance improvements, and many others.
Our internal docs-infra team currently shares responsibility for this domain, and they've developed features such as autogenerated OG images, multi-tab component demos, speed performance improvements, and more.

These features represent just the start, though.
There are a lot of great projects to get inspired by ([Nextra](https://nextra.site/) as a great example), as well as many ambitious projects we want to breathe life into!
For example, offering visitors the ability to toggle the design language they want to view the docs on, adding offline support, custom component demo customization supported by AI, and so much more.
There are so many other features we'd like to implement, and projects we could draw inspiration from (e.g., [Nextra](https://nextra.site/))—but the existing team (each of whom spends most of their time on one of our product engineering teams) simply doesn't have the bandwidth to take on bigger and more ambitious projects.
For example, we could offer visitors the ability to toggle the design language they want to view the docs in; add offline support; use AI to provide component demo customization; and so much more.

With all of that in mind, we're looking for someone to own this scope as a first-class product within the organization, concretely becoming the first full-time dedicated engineer to it.
That's why we're looking for a skilled full-stack developer to own the docs infrastructure as their full-time responsibility.

## The role

The Docs Infra team currently doesn't have anyone dedicated to it full-time.
So, as the first React engineer to be primarily focused on it, you will work on developing new features and infrastructure-related tasks that will, ultimately, make documentation generation and consumption smoother, better, and faster.
As the first full-time React engineer to own this domain, you will work on developing new features and infrastructure-related tasks to make documentation generation and consumption smoother, faster, and more intuitive.

This role involves touching on a piece of MUI's infrastructure that all of our products depend on, so you will have frequent opportunities to interact with the whole company.
On a day-to-day basis, it will be a very dynamic role, as you'll have tasks that range from being more operational to user-facing.
Because this role involves maintaining a platform that all of our products depend on, you will have frequent opportunities to foster cross-team collaboration to gather feedback and iterate on new features.
Day-to-day tasks may range from internal configuration improvements (e.g., working with Webpack, Babel, Netlify, and other ops tools) to user-facing feature implementation (e.g., developing a playground feature teams can use to showcase components), so you should be comfortable working across the full stack of a Next.js-based app.
You will also play a fundamental role in defining the Docs Infra roadmap and priorities.

### Key responsibilities

- Ensure the documentation feels fast and snappy for readers
You'll be closely keeping tabs on Lighthouse scores and bundle size
You'll be closely keeping tabs on Lighthouse scores, bundle size, and search quality
- Develop new features that will enhance the way the libraries are showcased
- Improve content findability by refining the documentation search quality
- Ensure SEO and accessibility are strong and stable
- Improve the documentation authoring experience for both the maintainers and the community
- Own any infrastructure-related tasks, like managing dependencies, analytics, TypeScript modules, and hosting allowing each product team to never worry about the documentation platform and be 100% focused on their product

Expand All @@ -74,35 +70,32 @@ You will also play a fundamental role in defining the Docs Infra roadmap and pri
- Migrate the docs platform to Next.js App Router
- Allow users to search the docs within a specific product scope
- Enable to store different parts of our documentation in different repositories
- Improve the blog experience by introducing new elements like a CMS
- Standardize the documentation design and layout across all of MUI's products
- Enhance code blocks with hoverable props that quickly show API descriptions
- Introduce a more scalable solution for hosting videos
- Introduce a CDN for managing images
- Introduce a more scalable solution for hosting videos and images

## Who we're looking for

### Required

- You're comfortable with the modern JavaScript ecosystem, which, aside from React, includes tools like TypeScript, Node.js, Next.js, Webpack, and Babel
- You're comfortable with the modern JavaScript ecosystem: we use React, TypeScript, Node.js, Next.js, Webpack, and Babel, among other tools
- You get energized to dive into complex problems
- You're excited about helping engineers and designers build amazing UIs
- You're highly empathetic
- Great written and spoken English skills
- Basic design skills
- You have great written and spoken English skills
- You have basic design sensibility

### Nice to have (but not required)

- Good design skills
- Strong design skills
- Experience in open-source
- Experience with design systems
- Experience with MUI products

## Benefits and compensation

Competitive compensation depending on the profile and location.
We are ready to pay top market rates for a person that can clearly exceed the role's expectations.
You can find the other perks & benefits on the [careers](https://mui.com/careers/#perks-and-benefits) page.
We offer competitive compensation commensurate with your experience level and location.
We're prepared to pay top market rates for someone who can clearly exceed the role's expectations.
You can find the other perks and benefits on the [careers](https://mui.com/careers/#perks-and-benefits) page.

## How to apply

Expand Down

0 comments on commit 8174aed

Please sign in to comment.