Open gosko opened 1 year ago
@koalie @vivienlacourba I am happy to make these updates to the text directly if you confirm my understanding of the expected use of the design system.
@gosko thanks for noticing those and volunteering to update the content. Please work on a PR with edits you see fit and set me as reviewer.
Is it our intent for this design system to be used by others when creating their own sites? My expectation is that it was primarily to be used for W3C's site, though others are welcome to copy and adapt it for their purposes.
Yes, you are correct in your assumption. Therefore, it's indeed best to update the verbiage to match that expectation, in
The Getting started page says:
The assets are automatically compiled and deployed on the W3C CDN under https://www.w3.org/assets/website-2021/. You may link to them directly in any types of projects.
The Design System site has some text that I feel could use some clarification:
Is it our intent for this design system to be used by others when creating their own sites? My expectation is that it was primarily to be used for W3C's site, though others are welcome to copy and adapt it for their purposes. The Getting started page says:
This implies that other sites are welcome to embed these assets directly from W3C's site, which I imagine is not intended even if we do want to encourage others to use these styles.
I think the general issue is that the content of the design system site was written by Studio 24 addressed to W3C staff and in that context the wording makes sense, but since it's public it could use some clarification to avoid people misinterpreting words like "you" and "your" to mean themselves instead of W3C.
Also I think this text:
would be better as:
in case that phrase is taken out of context.
@koalie @vivienlacourba I am happy to make these updates to the text directly if you confirm my understanding of the expected use of the design system.