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] Revise the Contributing Guide #39190

Merged
merged 10 commits into from
Oct 12, 2023
Merged

[docs] Revise the Contributing Guide #39190

merged 10 commits into from
Oct 12, 2023

Conversation

mapache-salvaje
Copy link
Contributor

@mapache-salvaje mapache-salvaje commented Sep 27, 2023

  • Line breaks after each sentence for simpler line-by-line editing
  • "Pull Request" —> "pull request" or "PR" - not sure why it was capitalized throughout most of this doc
  • Sentence case for all headers
  • Parallel structure for list items
  • Rearranged steps for adding demos to the docs - it makes more sense to me to build the demo first, then add a section to the docs about it
  • Copyediting everywhere, but especially "Your first pull request" section
  • Grammar, style, typo fixes

@mapache-salvaje mapache-salvaje added the docs Improvements or additions to the documentation label Sep 27, 2023
@mui-bot
Copy link

mui-bot commented Sep 27, 2023

Netlify deploy preview

https://deploy-preview-39190--material-ui.netlify.app/

Bundle size report

No bundle size changes (Toolpad)
No bundle size changes

Generated by 🚫 dangerJS against 94265f2

@mapache-salvaje mapache-salvaje marked this pull request as ready for review September 27, 2023 19:31
Co-authored-by: Danilo Leal <67129314+danilo-leal@users.noreply.github.com>
Signed-off-by: Sam Sycamore <71297412+samuelsycamore@users.noreply.github.com>
Copy link
Contributor

@danilo-leal danilo-leal left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Woo, this is much better — thanks for picking it up! 💪
My comments are mostly about the usage of "MUI" and how it's confusing sometimes 😬

@mj12albert mj12albert mentioned this pull request Oct 3, 2023
2 tasks
Co-authored-by: Danilo Leal <67129314+danilo-leal@users.noreply.github.com>
Signed-off-by: Sam Sycamore <71297412+samuelsycamore@users.noreply.github.com>
Copy link
Member

@mbrookes mbrookes left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removing the Translations section on the basis that #39221 will it make redundant.

@mapache-salvaje mapache-salvaje changed the title [docs] Add note about translations to Contributing Guide, plus general copy editing [docs] Revise the Contributing Guide Oct 10, 2023
mapache-salvaje and others added 3 commits October 9, 2023 19:58
Co-authored-by: Matt <github@nospam.33m.co>
Signed-off-by: Sam Sycamore <71297412+samuelsycamore@users.noreply.github.com>
@mapache-salvaje
Copy link
Contributor Author

In place of the translations section, I added a line to the "Wide spectrum of contributions" section suggesting that folks start by opening an issue if they have an idea for an improvement.

@mapache-salvaje mapache-salvaje requested review from mbrookes and danilo-leal and removed request for mnajdova October 10, 2023 01:28
Copy link
Contributor

@danilo-leal danilo-leal left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks super good! Left some small considerations, but am dropping the approval already! 😄

@mbrookes mbrookes merged commit ec9178d into mui:master Oct 12, 2023
mnajdova pushed a commit to mnajdova/material-ui that referenced this pull request Oct 13, 2023
Signed-off-by: Sam Sycamore <71297412+samuelsycamore@users.noreply.github.com>
Co-authored-by: Danilo Leal <67129314+danilo-leal@users.noreply.github.com>
Co-authored-by: Matt <github@nospam.33m.co>
mnajdova pushed a commit to mnajdova/material-ui that referenced this pull request Oct 13, 2023
Signed-off-by: Sam Sycamore <71297412+samuelsycamore@users.noreply.github.com>
Co-authored-by: Danilo Leal <67129314+danilo-leal@users.noreply.github.com>
Co-authored-by: Matt <github@nospam.33m.co>
mnajdova pushed a commit to mnajdova/material-ui that referenced this pull request Oct 13, 2023
Signed-off-by: Sam Sycamore <71297412+samuelsycamore@users.noreply.github.com>
Co-authored-by: Danilo Leal <67129314+danilo-leal@users.noreply.github.com>
Co-authored-by: Matt <github@nospam.33m.co>
@mapache-salvaje mapache-salvaje deleted the contributing-translations branch April 3, 2024 17:24
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
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants