Merge pull request #258 from domaframework/translate-docs-from-into-english

Translate docs from Japanese into English

Author: nakamura-to

docs/dao.rst

@@ -1,34 +1,35 @@
 ==================
-Daoインタフェース
+Dao interfaces
 ==================
 
-.. contents:: 目次
+.. contents:: Contents
    :depth: 3
 
-Data Access Object （Dao） はデータベースアクセスのためのインタフェースです。
+Data Access Object (Dao) is interface for access to database.
 
-Dao定義
+Dao definition
 ==================
 
-Daoは ``@Dao`` が注釈されたインタフェースとして定義します。
+Dao is defined as interface annotated ``@Dao``.
 
-インタフェースの実装クラスはaptによりコンパイル時に自動生成されます。
+Class implemented dao interface is generated in compile time by apt.
 
-クエリ定義
+Query definition
 ==================
 
-アノテーションを使って :doc:`query/index` を定義できます。
+:doc:`query/index` can be defined using annotation.
 
-Javaコードで任意のクエリを組み立てるには `デフォルトメソッド`_ の中で :doc:`query-builder/index` を使用してください。
+You use :doc:`query-builder/index` in `default method`_ if you want to build query freely in Java code.
 
 .. _dao-default-method:
 
-デフォルトメソッド
+Default method
 ==================
 
-デフォルトメソッドでは任意の処理を記述できます。
+You can write java code freely in default method.
+
+You can get ``Config`` instance associated dao instance if you call ``Config.get`` with argument dao instance.
 
-``Config.get`` にDaoのインスタンスを渡すとDaoに関連づけられた ``Config`` インスタンスを取得できます。
 
 .. code-block:: java
 
@@ -43,40 +44,40 @@ Javaコードで任意のクエリを組み立てるには `デフォルトメ
       }
   }
 
-利用例
+Example
 ==================
 
-コンパイルすると注釈処理により実装クラスが生成されます。
-実装クラスをインスタンス化して使用してください。
-ただし、設定クラスをDIコンテナで管理する場合、インスタンス化はDIコンテナで制御してください。
+Implementation class is generated by annotation processor on compile.
+Implementation class is instantiated and used.
+But if configuration class is managed by DI container then it should be controlled to instantiate implementation class by DI container.
 
 .. code-block:: java
 
   EmployeeDao employeeDao = new EmployeeDaoImpl();
   Employee employee = employeeDao.selectById(1);
 
-デフォルトでは、実装クラスの名前はインタフェースの名前に ``Impl`` をサフィックスしたものになります。
-パッケージやサフィックスを変更するには :doc:`annotation-processing` を参照してください。
+In default, implementation class name is interface name suffixed with ``Impl``.
+Please refer :doc:`annotation-processing` to change package and suffix.
 
-デフォルトコンストラクタを使用した場合は、 ``@Dao`` の ``config`` 要素に指定した設定により ``DataSource`` が決定されますが、
-特定の ``DataSource`` を指定してインスタンス化することも可能です。
+If you use default constructor then ``DataSource`` is determined by configuration in ``config`` element of ``@Dao``.
+But it can instantiate with ``DataSource`` specified explicitly.
 
 .. code-block:: java
 
   DataSource dataSource = ...;
   EmployeeDao employeeDao = new EmployeeDaoImpl(dataSource);
   Employee employee = employeeDao.selectById(1);
 
-また同様に、 ``Connection`` を指定してインスタンス化することも可能です。
+And also, it can instantiate with ``Connection`` specified explicitly.
 
 .. code-block:: java
 
   Connection connection = ...;
   EmployeeDao employeeDao = new EmployeeDaoImpl(connection);
   Employee employee = employeeDao.selectById(1);
 
-Daoインタフェースはエンティティクラスと1対1で結びついているわけではありません。
-ひとつのDaoインタフェースで複数のエンティティクラスを扱えます。
+Dao interface is no need to define as one to one with entity class.
+One dao interface can handle more than one entity classes.
 
 .. code-block:: java