[polaris.shopify.com] Feedback (on /components/layout-and-structure/layout)

[ersanjay1995]

I hope this email finds you well. I am writing to bring to your attention a few challenges I have encountered while working with Shopify Polaris, particularly with regards to its documentation and resources.

Code Examples for HTML and React: While referring to the Polaris Viz documentation, I noticed that examples in both HTML and React were not available previously. It would be extremely helpful if these examples could be added, as they are crucial for developers to implement Polaris effectively in various scenarios.

Versioning Confusion: With every new version of Polaris, it becomes more difficult to identify which components are still active and which are deprecated. A clearer distinction between the active and deprecated components in the documentation would greatly improve the user experience and reduce confusion.

Layout Design Examples: While I understand Polaris supports multiple layout configurations, I find it challenging to design layouts efficiently due to the limited number of examples and code snippets available. Frameworks like Bootstrap provide detailed component guides, from basic to advanced use cases. A similar approach for Polaris, including more layout-focused examples, would enhance the overall developer experience.

I appreciate the work being done on Polaris, and with these improvements, I believe it would become even more powerful and user-friendly for developers like myself.

Thank you for considering these suggestions. Please let me know if I can provide further feedback or if there is any other information you need.