[RFC] Create dashboard for tracking repository health

[mnajdova]

This discussion is around defining the requirements for a dashboard for tracking the health of the repository. Here is a list of questions we want to answer with the dashboard and proposals for charts that would help with it.

1. Is the number of newly created issues growing over time?

• How to get the information: Line chart - number of new issues per day over time
• What we will gain: We will see trends of when the number of new issues increases/decreases. Is the number of new issues per day growing over time

2. How fast are we handling issues/Are there enough resources for it?

• How to get the information? Line Chart - number of open issues per date
• What we will gain? We will see trends of growing issues over time/whether we need to increase the time spend for handling issues.

3. Which areas of the codebase need improvements?

• How to get the information? Pie Chart - number of open issues per label that contain the bug label
• What we will gain? We will see which areas of the codebase have the biggest number of bugs reported so far.

4. Which areas of the codebase need better documentation?

• How to get the information? Pie Chart - number of issues per label that contain the support label
• What we will gain? We will see which areas of the codebase have the biggest number of support requests so far, which should indicate that we need better documentation for them.

---

Feel free to leave more suggestions below.

[mbrookes]

Perhaps the documentation feedback could also be pulled in to the same dashboard?

[mnajdova]

What are you referring to with documentation feedback?

[mbrookes]

The feedback buttons and form at the bottom of each docs page:

[eps1lon]

That was always the goal of https://mui-dashboard.netlify.app/ but I couldn't find the time to add everything I wanted.

The code is owned by the org so feel free to push whatever changes you want to see there.

[mnajdova]

Thanks for sharing it. Will look into it.

[danilo-leal]

Not strictly related to the repo's health but does it makes sense to have a pie chart displaying how many PRs are opened by community contributors vs maintainers? I'm not aware if we have this recorded somewhere...I think it could be interesting to see if at any point the community is less engaged with actually pushing changes and contributing. If so, it could help us to prioritize and brainstorm initiatives that would boost contributors' participation.

[oliviertassinari]

An attempt @mnajdova had with our own set of components: https://mui-repository-health-dashboard.vercel.app/.

[mbrookes]

Other tools:

• https://ossinsight.io/
• https://app.swarmia.com/