-
-
Notifications
You must be signed in to change notification settings - Fork 32.8k
[website] Open the Docs-infra engineer role #42101
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from 22 commits
Commits
Show all changes
23 commits
Select commit
Hold shift + click to select a range
cf213f7
add the job ad page
danilo-leal 81da66e
add it on the careers page
danilo-leal b1d8d5a
remove unnecessary period
danilo-leal 60067b5
oops: left this one unfinished — fill it up; regarding code blocks
danilo-leal f69de08
add wild/ambitious initiatives as examples
danilo-leal 8b8b31d
rephrase again to include Nextra as an example
danilo-leal 3b1bc78
rephrase things a bit
danilo-leal 5f6fce0
Sam's review
danilo-leal 8940185
lint: e.g., → for example
danilo-leal 2637eeb
update with the template
danilo-leal b235b10
lint: remove e.g again
danilo-leal 0bc13d2
Sam's latest update
danilo-leal deacb8e
normalize on Docs-infra
oliviertassinari 7ff26de
Why it's important
oliviertassinari 1eeefec
give some examples
oliviertassinari 258018e
Starlink makes me feel like offline mode need is heavily trending out.
oliviertassinari 55d53ab
could be confusing, it's not a full-stack role
oliviertassinari d0063a1
Babel is trending downward, and we have other needs for AST transform…
oliviertassinari ea7bfd6
if design is how things work, we need more than basic
oliviertassinari 51b58a0
more important
oliviertassinari a3d1da1
could be someone junior with high potential but needs to be at least …
oliviertassinari 5bc62fc
link post
oliviertassinari 08becf1
pnpm docs:i18n
oliviertassinari File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,7 @@ | ||
| import * as React from 'react'; | ||
| import TopLayoutCareers from 'docs/src/modules/components/TopLayoutCareers'; | ||
| import * as pageProps from 'docs/pages/careers/react-engineer-docs-infra.md?muiMarkdown'; | ||
|
|
||
| export default function Page() { | ||
| return <TopLayoutCareers {...pageProps} />; | ||
| } |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,110 @@ | ||
| # React Engineer — Docs-infra | ||
|
|
||
| <p class="description">You will drive the development and maintenance of the documentation platform that powers all MUI products.</p> | ||
|
|
||
| ## Details of the role | ||
|
|
||
| - **Location**: Remote (preference for UTC-5 to UTC+2). | ||
| - **Type of work**: Full-time (contractor or employee [depending on circumstances](https://mui-org.notion.site/Hiring-FAQ-64763b756ae44c37b47b081f98915501#494af1f358794028beb4b7697b5d3102)). | ||
| - **Level**: [confirmed IC3 or above](https://mui-org.notion.site/Leveling-at-MUI-5c30f9bfe65149d697f346447cef9db1). | ||
| - We're a **remote** company, we prefer asynchronous communication over meetings. | ||
|
|
||
| ## The company | ||
|
|
||
| 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 35+ people as of early 2024, and we're growing. | ||
|
|
||
| ## The products | ||
|
|
||
| MUI is best known for our flagship product, Material UI—but this is just one of three core component libraries we maintain. | ||
danilo-leal marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| Base UI is our headless component library, and Joy UI is a sister library to Material UI that implements our own in-house Joy Design system. | ||
| We also host Design Kits and pre-built Templates. | ||
|
|
||
| Beyond the core libraries, MUI X offers advanced components like the Data Grid, Date and Time Pickers, and Charts, for more complex user interactions and data visualization needs. | ||
|
|
||
| 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/). | ||
|
|
||
| ## The culture | ||
|
|
||
| MUI is a fully remote company with a team that spans the globe. | ||
| The majority of our work is asynchronous, and we rely on written communication to collaborate. | ||
| We're radically transparent: nearly all of our work happens in public. | ||
| Each contributor has the freedom to decide how and when they work, and that work is primarily self-directed: it's your responsibility to define and complete your own tasks in a timely manner. | ||
|
|
||
| Learn more about what we value as an organization: [Evolving MUI's core values and behaviors](https://mui.com/blog/2023-mui-values/). | ||
|
|
||
| ## Why we're hiring | ||
danilo-leal marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
||
| 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. | ||
| It's a differentiating factor for the product. | ||
|
|
||
| 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. | ||
|
|
||
| Our internal Docs-infra team currently shares responsibility for this domain, and they've developed features such as [autogenerated](https://x.com/olivtassinari/status/1783894370011213869) OG images, multi-tab component demos, [speed](https://github.com/mui/material-ui/pull/40314) performance improvements, and more. | ||
|
|
||
| There are so many other features we'd like to implement, and projects we could draw inspiration from (for example, [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 automatic conversion of demos to Tailwind CSS; use AI to provide component demo customization; and so much more. | ||
|
|
||
| That's why we're looking for a skilled JavaScript developer to own the docs infrastructure as their full-time responsibility. | ||
|
|
||
| ## The role | ||
|
|
||
| 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. | ||
|
|
||
| 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 (for example, working with Webpack, AST transformation tools, Netlify, and other developer tools) to user-facing feature implementation (for example, 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 | ||
danilo-leal marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
||
| - Ensure the documentation feels fast and snappy for readers | ||
| - Monitor Lighthouse scores, bundle size, and search quality to make incremental improvements | ||
| - Develop new features that will enhance the way the libraries are showcased | ||
| - Improve the documentation authoring experience for both the maintainers and the community | ||
| - Own infrastructure tasks like managing dependencies, analytics, TypeScript modules, and hosting, so product teams can stay focused on their primary responsibilities | ||
|
|
||
| ### Tasks and initiatives you might take on | ||
|
|
||
| - Migrate the docs platform to the Next.js App Router | ||
| - Allow users to search the docs within a specific product scope | ||
| - Make it possible to store different parts of our documentation in different repositories | ||
| - Standardize the documentation design and layout across all of MUI's products | ||
| - Introduce a more scalable solution for hosting videos and images | ||
|
|
||
| ## Who we're looking for | ||
|
|
||
| ### Required | ||
|
|
||
| - 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 | ||
| - You have good product/design sensibility | ||
| - You have great written and spoken English skills | ||
|
|
||
| ### Nice to have (but not required) | ||
|
|
||
| - Strong product/design skills | ||
| - Experience in open-source | ||
| - Experience with design systems | ||
| - Experience with MUI products | ||
|
|
||
| ## Benefits and compensation | ||
|
|
||
| We offer competitive compensation commensurate with your experience level and location and are 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 | ||
|
|
||
| [Apply now for this position 📮](https://jobs.ashbyhq.com/MUI/673f3178-56f4-47fd-bd2b-6dcba57758aa/application?utm_source=ZNRrPGBkqO) | ||
| (will add the link once we publish the role also on Ashby) | ||
|
|
||
| Don't meet every requirement? | ||
| Apply anyway! | ||
| Research shows that certain folks are less likely to apply for a role than others [unless they meet 100%](https://hbr.org/2014/08/why-women-dont-apply-for-jobs-unless-theyre-100-qualified) of the outlined qualifications. | ||
| If this role excites you, we want to hear from you. | ||
| We'd love for you to share the unique skills, passion, and experience you could bring to MUI. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.