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

fix(docs): minor UX Writing Guide copy to match Dev Center IA conventions #1334

Merged
merged 3 commits into from
Jan 31, 2024

Conversation

slsriehl
Copy link
Contributor

@slsriehl slsriehl commented Jan 23, 2024

What?

Describe what changes you are making. e.g. Adds X prop in the Box component.

  • upcase titles

Why?

Please provide the reason(s) why you are making this change? Please no one-liners like, It was missing.; expand upon the reason like, Adds X prop because it was missing in the Box component. Documentation notes this prop exists, but it actually wasn't implemented.

  • the Dev Center uses title case titles and sentence case headings inside each doc. the Guide now conforms to that.

Screenshots/Screen Recordings

This is a component library so we love visually looking at changes! If this applies to your pull request, show us your hard work in action.

Testing/Proof

Explain how you tested your new feature or bugfix. Please refrain from one-liners like, Added tests.; expand upon how you tested your changes like, Added local tests to the new component and ensured test coverage was met. Manually tested on Safari@x.x.x..

ping @bc-ghough @davelinke

@slsriehl slsriehl requested review from a team as code owners January 23, 2024 21:59
@slsriehl slsriehl requested a review from markcmurphy January 23, 2024 21:59
chanceaclark
chanceaclark previously approved these changes Jan 23, 2024
@slsriehl slsriehl marked this pull request as draft January 23, 2024 22:07
@slsriehl slsriehl added the do not merge Don't merge this PR! label Jan 23, 2024
@slsriehl
Copy link
Contributor Author

converted to draft and do not merge label added -- merge or close pending review and approval from @bigcommerce/product-design. cc @bc-ghough.

@bc-ghough
Copy link

Product Design has had a team sync (1/24) on this PR and want to reiterate that this guide is for apps, integrations and our control panel. It should not reflect the writing rules for the dev documentation. We also discussed the term "Content guide" and decided the section name should be reverted back to "UX Writing Guide as 'UX Writing' is very different than 'Content Guide'

@slsriehl slsriehl changed the title fix(docs): minor Content Guide copy to match Dev Center IA conventions fix(docs): minor UX Writing Guide copy to match Dev Center IA conventions Jan 30, 2024
@slsriehl slsriehl dismissed chanceaclark’s stale review January 30, 2024 21:59

changes since review

@slsriehl
Copy link
Contributor Author

Do not merge without approval from @bc-ghough

@slsriehl slsriehl marked this pull request as ready for review January 30, 2024 22:09
@slsriehl slsriehl merged commit 06cee60 into main Jan 31, 2024
11 checks passed
@chanceaclark chanceaclark deleted the ux-content-guide branch August 16, 2024 21:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
do not merge Don't merge this PR!
Development

Successfully merging this pull request may close these issues.

4 participants