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

Reduce specific guidance in textual formats principle and link to other principles instead #531

Open
LeaVerou opened this issue Dec 4, 2024 · 1 comment

Comments

@LeaVerou
Copy link
Member

LeaVerou commented Dec 4, 2024

We just merged PR #505 but a lot of its guidance needs to be split out to separate principles, e.g.:

  • should we have a principle about syntactic flexibility?
  • should we have a principle about specifications needing to fully define processing and error handling so that all inputs result in consistent outcomes?

Then this principle should link to those and any other relevant principles (PoC, consistency, tradeoffs between high-level and low-level APIs, making simple things easy and complex things possible, etc.)

@martinthomson
Copy link
Contributor

The text in that pull request cited https://w3ctag.github.io/design-principles/#avoid-ambiguity for the latter one. I think that we can do more on the former. There are plenty of interesting factors to balance.

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

No branches or pull requests

2 participants