3.5

source/chp2.rst

@@ -305,6 +305,31 @@ tmp
  * 有时，我们想要在本地运行性能测试，且不想记录降低运行速度，因此我们不能使用 `--run_locally` 。
 
 
+问题是， `--run_locally` 通常用于它的名字所表示的情况下。作为替代，像 `--extra_logging` 这样的标志名应该是更直接和清楚的。
+
+但是，如果 `--run_locally` 需要做的不仅仅是额外的日志记录？例如，假设需要建立和使用一个特殊的本地数据库。现在 `--run_locally` 这个名字看起来更吸引人，因为对这两个方面它都可以控制。
+
+但是使用它的目的是要挑选一个含糊的和不直接的名字，这可能不是一个好的主意。一个更好的解决方案是产生一个名叫 `--use_local_database` 的第二个标志。纵然现在，你不得不使用两个标志，但是这两个标志会更清楚；它们不会尝试去打破两个正交的概念而融为一体，并且它们给你只使用一个，而不用另一个的选择。
+
+
+附加额外的信息到一个名字
+---------------------------
+
+\
+
+.. figure:: _static/2-3.*
+   :align: center
+
+正如我们前面所提及的，一个变量名如同一个微小的注释。即使没有没有太多的空间，任何被你挤入名字的额外信息，在每次变量出现的时候都可以被看见。
+
+因此，如果关于变量有什么非常重要的事情，读者必须知道的话，附加一个额外的“字”到名字是值得的。例如，假设你有一个变量包含一个十六进制的字符窜：
+
+  ::
+
+    string id;  // 例："af84ef845cd8"
+
+带有单位的值
+++++++++++++++