提交 c4501f22 编写于 作者: H Hixie

Give rationale for style guide, suggest using more concise code when doing so...

Give rationale for style guide, suggest using more concise code when doing so doesn't harm readability.
TBR=abarth

Review URL: https://codereview.chromium.org/1209003002.
上级 81f74478
......@@ -3,6 +3,10 @@ Sky Style Guide
In general, follow our [Design Principles](design.md) for all code.
The primary goal of this style guide is to improve code readability so
that everyone, whether reading the code for the first time or
maintaining it for years, can quickly determine what the code does. A
secondary goal is avoiding arguments when there are disagreements.
Dart
----
......@@ -83,6 +87,26 @@ the expression, even if it is short. (Doing so makes it unobvious that
there is relevant code there. This is especially important for early
returns.)
If a flow control structure has just one statement, then don't use
braces around it except where doing so would help readability or avoid
the dangling-else problem. Keeping the code free of boilerplate or
redundant punctuation keeps it concise and readable.
> For example,
> ```dart
> if (children != null)
> for (RenderBox child in children)
> add(child);
> ```
> ...rather than:
> ```dart
> if (children != null) {
> for (RenderBox child in children) {
> add(child);
> }
> }
> ```
Use the most relevant constructor or method, when there are multiple
options.
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册