Design guidelines for new library features

tc39 / proposal-built-in-modules

BSD 2-Clause "Simplified" License

892 stars 25 forks source link

Design guidelines for new library features #42

Open k15a opened 5 years ago

k15a commented 5 years ago

Identifiers should have clear names and don't use abbreviations as this makes them a lot more clear and easy to read. For example, having a function called lessThan is easier to understand than lt. The same applies for length over len

As most of the current identifiers are no abbreviations as well it would make the library much more consistent with the rest of the language.

littledan commented 5 years ago

There is a broader point here: should we develop a design guide for the standard library proposals? The Web has https://w3ctag.github.io/design-principles/. TC39 has thought about making a "rationale" repo; maybe this should go there.