diff options
| author | 迷渡 <justjavac@gmail.com> | 2019-08-28 21:51:36 +0800 |
|---|---|---|
| committer | Ryan Dahl <ry@tinyclouds.org> | 2019-08-28 09:51:36 -0400 |
| commit | 1d34f11a873d640ac2611bcabee5875a27f43a2e (patch) | |
| tree | 4768a60c2efad0f034228f0c0b7da5ce253c7cd3 | |
| parent | 20739a8111658c088e291503866110117e117792 (diff) | |
doc: fix list style (#2823)
| -rw-r--r-- | website/style_guide.md | 9 |
1 files changed, 7 insertions, 2 deletions
diff --git a/website/style_guide.md b/website/style_guide.md index d1eff8357..e701ac0b3 100644 --- a/website/style_guide.md +++ b/website/style_guide.md @@ -54,17 +54,22 @@ When designing function interfaces, stick to the following rules. there is only one, and it seems inconceivable that we would add more optional parameters in the future. +<!-- prettier-ignore-start --> +<!-- see https://github.com/prettier/prettier/issues/3679 --> + 3. The 'options' argument is the only argument that is a regular 'Object'. Other arguments can be objects, but they must be distinguishable from a 'plain' Object runtime, by having either: - - a distinguishing prototype (e.g. `Array`, `Map`, `Date`, `class MyThing`) - - a well-known symbol property (e.g. an iterable with `Symbol.iterator`). + - a distinguishing prototype (e.g. `Array`, `Map`, `Date`, `class MyThing`) + - a well-known symbol property (e.g. an iterable with `Symbol.iterator`). This allows the API to evolve in a backwards compatible way, even when the position of the options object changes. +<!-- prettier-ignore-end --> + ```ts // BAD: optional parameters not part of options object. (#2) export function resolve( |