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

Add a section on References #23

Closed
Malvoz opened this issue Oct 27, 2020 · 3 comments · Fixed by #52
Closed

Add a section on References #23

Malvoz opened this issue Oct 27, 2020 · 3 comments · Fixed by #52

Comments

@Malvoz
Copy link
Member

Malvoz commented Oct 27, 2020

The explainer currently only mentions the HTML Design Principles. I think it's appropriate to also mention the Web Platform Design Principles.

@prushforth
Copy link
Member

Interesting, and agree these are an informative reference. Will read, and add references as appropriate / that I recognize as applying in particular. @shepazu recommended that I write two separate 'explainers', one which is a high-level one/two page executive summary-type explainer, and this one which goes deeper and in principle tries to follow the TAG advice on explainers, resulting in a lot of detail, which has resulted in people complaining that the explainer is too long.

Keeping this issue open as a way of saying to self: "Add a section on References", per the TAG guidelines template.

@Malvoz Malvoz changed the title Include the Web Platform Design Principles Add a section on References Nov 3, 2020
@prushforth
Copy link
Member

The explainer currently only mentions the HTML Design Principles. I think it's appropriate to also mention the Web Platform Design Principles.

Found a good reference by browsing this document, the TAG Ethical Web Principles. The latter could even factor into the requirements and use cases, I dare say.

@Malvoz
Copy link
Member Author

Malvoz commented Aug 13, 2021

Found a good reference by browsing this document, the TAG Ethical Web Principles

The TAG Ethical Web Principles are linked from the Web Platform Design Principles.

And when you submit an Early design review to TAG there's an item to check if you've reviewed the Web Platform Design Principles, nothing about HTML design principles, I believe the former is simply treated as a successor to the latter.

We should close this issue out by replacing HTML design principles with Web Platform Design Principles. Don't think there's anything else to be done here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants