mui / mui/material-ui

[docs-infra] API type expander/explorer

Open
#41,294 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

scope: docs-infra type: new feature waiting for 👍
Dominant language
JavaScript
Stars
99.1k
Forks
32.5k
Avg merge
2d 17h
Merged PRs (30d)
106

Description

Summary

We could make it possible to expand the types that we show on the API docs pages. The idea being to expand types until you eventually land on the root docs pages (MDN or React docs).

Examples

https://github.com/mui/material-ui/assets/3165635/ca661a1b-8c1f-4495-a595-4899083c9824

Motivation

Improve DX. It's a bit similar to #41073 but going above and beyond.

Search keywords: API types expander

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the API docs page for ActionGroup and compare the proposed behavior with issue #41073 and the linked example. Define how API types should expand through the generated docs until reaching MDN or React documentation, and consider the work complete when this behavior is implemented consistently across API docs pages.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, react
Domain
developer-experience, documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.