__name__ guarantee no name collisions

yoichi · yoichi · commit 330e62042bc3 · 2017-03-18T12:15:24.000+09:00
- was: "__name__ doesn't guarantee ..."
- clarify Cons of ways to configure
diff --git a/docs/writing/logging.rst b/docs/writing/logging.rst
@@ -77,7 +77,7 @@
 .. hierarchy of loggers using dot notation, so using ``__name__`` ensures
 .. no name collisions.
 
-ライブラリ内のロガーをインスタンス化する際のベストプラクティスは、グローバル変数 ``__name__`` を使用してロガーを作成することです。:mod:`logging` モジュールはドット表記を使用してロガーの階層を作成するので、``__name__`` を使用すると名前の衝突は保証されません。
+ライブラリ内のロガーをインスタンス化する際のベストプラクティスは、グローバル変数 ``__name__`` を使用してロガーを作成することです。:mod:`logging` モジュールはドット表記を使用してロガーの階層を作成するので、``__name__`` を使用すると名前が衝突しないと保証されます。
 
 .. Here is an example of best practice from the `requests source`_ -- place
 .. this in your ``__init__.py``
@@ -135,10 +135,10 @@
 
 - INI形式のファイルを使用する:
     - **Pro**: :func:`logging.config.listen` 関数を使って実行中に設定を更新することができます。
-    - **Con**: ロガーをコードで構成するときは、できるだけコントロールしない（たとえば、カスタムサブクラスのフィルターやロガー）ことはできません。
+    - **Con**: ロガーをコードで設定するときほど、（たとえば、カスタムサブクラスのフィルターやロガーのようには）細かく制御できません。
 - 辞書またはJSON形式のファイルを使用する:
     - **Pro**: 実行中に更新することに加えて、Python 2.6から標準ライブラリに :mod:`json` モジュールを使用してファイルからロードすることができます。
-    - **Con**: コードでロガーを設定するよりも制御が少ない。
+    - **Con**: コードでロガーを設定するときほど細かく制御できません。
 - コードを使う:
     - **Pro**: 設定を完全に制御します。
     - **Con**: 変更にはソースコードを変更する必要があります。
