Skip to content
This repository has been archived by the owner on Feb 23, 2024. It is now read-only.

Improve public-facing texts and labels #7045

Merged
merged 2 commits into from
Sep 12, 2022
Merged

Conversation

sunyatasattva
Copy link
Contributor

We noticed that oftentimes our labels and text tend to be overly technical or unclear. We decided to do a bulk pass to improve the readability to non-technical users. I understand that this is a big PR that touches loads of files. Also, we need to find a way to relay to our community of translators that work is required. As such, we also need to decide when it would be best to publish this PR, as it would indeed break many translations. So, for example, I think it might be best to publish it soon after we merge into core, in order to give translators a full release cycle time to fix their translations.

Feel free to use this PR as a hub of discussion for that.

Fixes #6916

WooCommerce Visibility

  • WooCommerce Core
  • Feature plugin
  • Experimental

Changelog

Improved many of the labels to be less technical and more user-friendly.

We noticed that oftentimes our labels and text tend to be overly
technical or unclear. We decided to do a bulk pass to improve
the readability to non-technical users.
@sunyatasattva sunyatasattva added type: enhancement The issue is a request for an enhancement. focus: accessibility The issue/PR is related to accessibility. focus: i18n The issue/PR is related to internationalization. type: refactor The issue/PR is related to refactoring. labels Sep 2, 2022
@sunyatasattva sunyatasattva self-assigned this Sep 2, 2022
@rubikuserbot rubikuserbot requested review from a team and albarin and removed request for a team September 2, 2022 15:17
@github-actions
Copy link
Contributor

github-actions bot commented Sep 2, 2022

The release ZIP for this PR is accessible via:

https://wcblocks.wpcomstaging.com/wp-content/uploads/woocommerce-gutenberg-products-block-7045.zip

@github-actions
Copy link
Contributor

github-actions bot commented Sep 2, 2022

Size Change: -1.04 kB (0%)

Total Size: 872 kB

Filename Size Change
build/active-filters-frontend.js 7.31 kB -34 B (0%)
build/active-filters.js 7.98 kB -35 B (0%)
build/all-products-frontend.js 18.1 kB +2 B (0%)
build/all-products.js 33.9 kB -16 B (0%)
build/all-reviews.js 7.79 kB -9 B (0%)
build/attribute-filter-frontend.js 22.1 kB +3 B (0%)
build/attribute-filter.js 13.1 kB -18 B (0%)
build/cart-blocks/cart-express-payment-frontend.js 5.08 kB -11 B (0%)
build/cart-frontend.js 47.1 kB +8 B (0%)
build/cart.js 41.8 kB +17 B (0%)
build/checkout-blocks/billing-address-frontend.js 887 B -3 B (0%)
build/checkout-blocks/express-payment-frontend.js 5.37 kB -12 B (0%)
build/checkout-blocks/payment-frontend.js 7.68 kB -11 B (0%)
build/checkout-frontend.js 49.3 kB +30 B (0%)
build/checkout.js 43.1 kB -16 B (0%)
build/featured-category.js 13.2 kB -44 B (0%)
build/featured-product.js 13.4 kB -72 B (-1%)
build/handpicked-products.js 7.29 kB -82 B (-1%)
build/legacy-template.js 2.77 kB -19 B (-1%)
build/mini-cart-contents-block/footer--mini-cart-contents-block/products-table-frontend.js 4.69 kB -2 B (0%)
build/mini-cart-contents.js 22.9 kB +4 B (0%)
build/mini-cart.js 4.56 kB -19 B (0%)
build/price-filter-frontend.js 13.4 kB +20 B (0%)
build/price-filter.js 9.33 kB +12 B (0%)
build/product-add-to-cart-frontend.js 6.95 kB -3 B (0%)
build/product-add-to-cart.js 6.87 kB -4 B (0%)
build/product-best-sellers.js 7.62 kB -90 B (-1%)
build/product-categories.js 2.36 kB -51 B (-2%)
build/product-category.js 8.61 kB -76 B (-1%)
build/product-new.js 7.62 kB -92 B (-1%)
build/product-on-sale.js 7.94 kB -81 B (-1%)
build/product-search.js 2.62 kB -32 B (-1%)
build/product-tag.js 8 kB -85 B (-1%)
build/product-top-rated.js 7.86 kB -89 B (-1%)
build/products-by-attribute.js 8.53 kB -99 B (-1%)
build/reviews-by-category.js 11.2 kB +11 B (0%)
build/reviews-by-product.js 12.3 kB -6 B (0%)
build/single-product.js 10 kB -12 B (0%)
build/stock-filter.js 7.52 kB -24 B (0%)
ℹ️ View Unchanged
Filename Size
build/blocks-checkout.js 17.4 kB
build/cart-blocks/cart-accepted-payment-methods-frontend.js 1.16 kB
build/cart-blocks/cart-items-frontend.js 298 B
build/cart-blocks/cart-line-items--mini-cart-contents-block/products-table-frontend.js 5.25 kB
build/cart-blocks/cart-line-items-frontend.js 430 B
build/cart-blocks/cart-order-summary-frontend.js 1.11 kB
build/cart-blocks/cart-totals-frontend.js 322 B
build/cart-blocks/empty-cart-frontend.js 346 B
build/cart-blocks/filled-cart-frontend.js 784 B
build/cart-blocks/order-summary-coupon-form-frontend.js 2.65 kB
build/cart-blocks/order-summary-discount-frontend.js 2.14 kB
build/cart-blocks/order-summary-fee-frontend.js 274 B
build/cart-blocks/order-summary-heading-frontend.js 452 B
build/cart-blocks/order-summary-shipping--checkout-blocks/order-summary-shipping-frontend.js 6.37 kB
build/cart-blocks/order-summary-shipping-frontend.js 427 B
build/cart-blocks/order-summary-subtotal-frontend.js 274 B
build/cart-blocks/order-summary-taxes-frontend.js 432 B
build/cart-blocks/proceed-to-checkout-frontend.js 1.16 kB
build/checkout-blocks/actions-frontend.js 1.42 kB
build/checkout-blocks/billing-address--checkout-blocks/shipping-address-frontend.js 4.12 kB
build/checkout-blocks/contact-information-frontend.js 2.83 kB
build/checkout-blocks/fields-frontend.js 344 B
build/checkout-blocks/order-note-frontend.js 1.07 kB
build/checkout-blocks/order-summary-cart-items-frontend.js 3.64 kB
build/checkout-blocks/order-summary-coupon-form-frontend.js 2.79 kB
build/checkout-blocks/order-summary-discount-frontend.js 2.26 kB
build/checkout-blocks/order-summary-fee-frontend.js 276 B
build/checkout-blocks/order-summary-frontend.js 1.11 kB
build/checkout-blocks/order-summary-shipping-frontend.js 602 B
build/checkout-blocks/order-summary-subtotal-frontend.js 274 B
build/checkout-blocks/order-summary-taxes-frontend.js 433 B
build/checkout-blocks/shipping-address-frontend.js 1.03 kB
build/checkout-blocks/shipping-methods-frontend.js 4.74 kB
build/checkout-blocks/terms-frontend.js 1.23 kB
build/checkout-blocks/totals-frontend.js 325 B
build/general-style-rtl.css 1.29 kB
build/general-style.css 1.29 kB
build/mini-cart-component-frontend.js 16.8 kB
build/mini-cart-contents-block/empty-cart-frontend.js 366 B
build/mini-cart-contents-block/filled-cart-frontend.js 229 B
build/mini-cart-contents-block/footer-frontend.js 6.98 kB
build/mini-cart-contents-block/items-frontend.js 237 B
build/mini-cart-contents-block/products-table-frontend.js 290 B
build/mini-cart-contents-block/shopping-button-frontend.js 288 B
build/mini-cart-contents-block/title-frontend.js 368 B
build/mini-cart-frontend.js 1.72 kB
build/price-format.js 1.19 kB
build/product-add-to-cart--product-button--product-category-list--product-image--product-price--product-r--a0326d00.js 223 B
build/product-add-to-cart--product-button--product-image--product-title.js 2.65 kB
build/product-button--product-category-list--product-image--product-price--product-rating--product-sale-b--e17c7c01.js 435 B
build/product-button--product-image--product-rating--product-sale-badge--product-title.js 300 B
build/product-button-frontend.js 1.87 kB
build/product-button.js 1.57 kB
build/product-category-list-frontend.js 878 B
build/product-category-list.js 502 B
build/product-image-frontend.js 1.88 kB
build/product-image.js 1.59 kB
build/product-price-frontend.js 1.9 kB
build/product-price.js 1.51 kB
build/product-query.js 648 B
build/product-rating-frontend.js 1.16 kB
build/product-rating.js 740 B
build/product-sale-badge-frontend.js 1.13 kB
build/product-sale-badge.js 802 B
build/product-sku-frontend.js 381 B
build/product-sku.js 379 B
build/product-stock-indicator-frontend.js 992 B
build/product-stock-indicator.js 624 B
build/product-summary-frontend.js 1.28 kB
build/product-summary.js 922 B
build/product-tag-list-frontend.js 873 B
build/product-tag-list.js 498 B
build/product-title-frontend.js 1.31 kB
build/product-title.js 922 B
build/reviews-frontend.js 7.02 kB
build/single-product-frontend.js 21.4 kB
build/stock-filter-frontend.js 7.61 kB
build/vendors--cart-blocks/cart-line-items--cart-blocks/cart-order-summary--cart-blocks/order-summary-shi--c02aad66-frontend.js 5.26 kB
build/vendors--cart-blocks/cart-line-items--checkout-blocks/order-summary-cart-items--mini-cart-contents---233ab542-frontend.js 3.14 kB
build/vendors--cart-blocks/order-summary-shipping--checkout-blocks/billing-address--checkout-blocks/order--5b8feb0b-frontend.js 4.84 kB
build/vendors--cart-blocks/order-summary-shipping--checkout-blocks/billing-address--checkout-blocks/order--decc3dc6-frontend.js 19.1 kB
build/vendors--mini-cart-contents-block/footer-frontend.js 6.86 kB
build/vendors--product-add-to-cart-frontend.js 7.53 kB
build/wc-blocks-data.js 9.87 kB
build/wc-blocks-editor-style-rtl.css 5.1 kB
build/wc-blocks-editor-style.css 5.1 kB
build/wc-blocks-google-analytics.js 1.56 kB
build/wc-blocks-middleware.js 931 B
build/wc-blocks-registry.js 2.7 kB
build/wc-blocks-shared-context.js 1.53 kB
build/wc-blocks-shared-hocs.js 1.71 kB
build/wc-blocks-style-rtl.css 23.2 kB
build/wc-blocks-style.css 23.2 kB
build/wc-blocks-vendors-style-rtl.css 1.95 kB
build/wc-blocks-vendors-style.css 1.95 kB
build/wc-blocks-vendors.js 54.5 kB
build/wc-blocks.js 2.63 kB
build/wc-payment-method-bacs.js 816 B
build/wc-payment-method-cheque.js 811 B
build/wc-payment-method-cod.js 909 B
build/wc-payment-method-paypal.js 837 B
build/wc-settings.js 2.6 kB

compressed-size-action

@@ -245,7 +245,7 @@ export const AddToCartFormStateContextProvider = ( {
const message =
data.processingResponse?.message ||
__(
'Something went wrong. Please contact us to get assistance.',
'Something went wrong. Please contact us for assistance. Please contact us to get assistance.',
Copy link
Contributor

Choose a reason for hiding this comment

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

This seems duplicated. The same is happening in four more of the Please contact us to get assistance. messages.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Wow thanks a lot for spotting that @albarin !

@github-actions github-actions bot added this to the 8.5.0 milestone Sep 6, 2022
@Aljullu Aljullu mentioned this pull request Sep 6, 2022
10 tasks
@sunyatasattva sunyatasattva merged commit d4e3247 into trunk Sep 12, 2022
@sunyatasattva sunyatasattva deleted the fix/public-facing-labels branch September 12, 2022 08:39
senadir pushed a commit to senadir/woocommerce-blocks that referenced this pull request Nov 12, 2022
We noticed that oftentimes our labels and text tend to be overly
technical or unclear. We decided to do a bulk pass to improve
the readability to non-technical users.
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
focus: accessibility The issue/PR is related to accessibility. focus: i18n The issue/PR is related to internationalization. type: enhancement The issue is a request for an enhancement. type: refactor The issue/PR is related to refactoring.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Improve public-facing text and labels
2 participants