Skip to content
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

[docs] Introduce User Persona for Enhanced Portuguese/Brazilian Documentation #42033

Closed
yassinmars opened this issue Apr 27, 2024 · 2 comments
Closed
Labels
docs Improvements or additions to the documentation support: docs-feedback Feedback from documentation page

Comments

@yassinmars
Copy link

yassinmars commented Apr 27, 2024

Related page

https://mui.com/material-ui/

Kind of issue

Other

Issue description

The current documentation primarily addresses English-speaking users. Introducing a user persona that reflects the needs and contexts of Portuguese-speaking developers, particularly from Brazil, could guide the adaptation of content to better suit this audience. This enhancement would support the ongoing efforts to translate the documentation into Portuguese, ensuring it's not only linguistically accurate but also culturally and contextually relevant. Attached is a screenshot of the user persona, Karla Almeidi, which outlines the typical characteristics and needs of our target audience.

user persona

Context

The goal of introducing a user persona for the Brazilian Portuguese-speaking segment of our community is to enhance the localization of the documentation. By grounding our translations and content adaptations in the real-world context of these users, we aim to make the documentation more accessible and useful to a wider audience. This approach not only helps in addressing the linguistic needs but also the specific use cases and cultural nuances that affect how the documentation is interpreted and implemented. This will also help fostering a more inclusive and engaging community around Material-UI, driving greater adoption and user satisfaction in these regions.

Search keywords: user persona, documentation, Brazilian Portuguese, accessibility, internationalization

@yassinmars yassinmars added status: waiting for maintainer These issues haven't been looked at yet by a maintainer support: docs-feedback Feedback from documentation page labels Apr 27, 2024
@danilo-leal
Copy link
Contributor

Hey @yassinmars, thanks for the issue! Even though I'm Brazilian myself and appreciate the intent here, we're not translating the docs anymore, so that's a bit out of our scope. Thanks again!

@danilo-leal danilo-leal closed this as not planned Won't fix, can't repro, duplicate, stale Apr 29, 2024
@zannager zannager added docs Improvements or additions to the documentation and removed status: waiting for maintainer These issues haven't been looked at yet by a maintainer labels Apr 29, 2024
@yassinmars
Copy link
Author

Hi @danilo-leal, Thank you for your feedback, but that was not my initial intention when i proposed this persona, my intention was to integrate user personas for strategic insights and development, i thought maybe by incorporating user personas like this, we could enhance the UI/UX design, making sure that Material-UI is as intuitive and accessible as possible for a significant segment of our user base. This could lead to increased engagement and satisfaction, helping Material-UI better serve global markets.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Improvements or additions to the documentation support: docs-feedback Feedback from documentation page
Projects
None yet
Development

No branches or pull requests

3 participants