diff --git a/docs/src/docs/asciidoc/multipleDataSources/dataServices.adoc b/docs/src/docs/asciidoc/multipleDataSources/dataServices.adoc
new file mode 100644
index 000000000..87efacab9
--- /dev/null
+++ b/docs/src/docs/asciidoc/multipleDataSources/dataServices.adoc
@@ -0,0 +1,19 @@
+
+GORM Data Services can operate on multiple data sources.
+
+The `@Transactional` annotation can specify the `DataSource` where `ZipCode` domains exists.
+
+When no annotation is used, then the service goes to the default `DataSource`, as in `deleteByCode(String code)`.
+
+[source,groovy]
+----
+@CompileStatic
+@Service(ZipCode)
+interface ZipCodeService {
+
+    @Transactional('lookup')
+    ZipCode findByCode(String code)
+
+    void deleteByCode(String code)
+}
+----
diff --git a/docs/src/docs/asciidoc/multipleDataSources/index.adoc b/docs/src/docs/asciidoc/multipleDataSources/index.adoc
index 5648f086e..b689e7c23 100644
--- a/docs/src/docs/asciidoc/multipleDataSources/index.adoc
+++ b/docs/src/docs/asciidoc/multipleDataSources/index.adoc
@@ -30,3 +30,11 @@ for(ConnectionSource<SessionFactory, HibernateConnectionSourceSettings> connecti
 	SessionFactory sessionFactory = connectionSource.source
 }
 ----
+
+=== Data Services with Multiple Data Sources
+
+include::dataServices.adoc[]
+
+=== Queries with Multiple Data Sources
+
+include::queries.adoc[]
diff --git a/docs/src/docs/asciidoc/multipleDataSources/queries.adoc b/docs/src/docs/asciidoc/multipleDataSources/queries.adoc
new file mode 100644
index 000000000..1c885cd20
--- /dev/null
+++ b/docs/src/docs/asciidoc/multipleDataSources/queries.adoc
@@ -0,0 +1,23 @@
+
+Queries can be written for mulitiple data sources with a dynamic finder, where query, or criteria query as well.
+
+Where Query:
+
+[source,groovy]
+----
+ZipCode.where {}.withConnection('lookup').list()
+----
+
+Dynamic Finder:
+
+[source,groovy]
+----
+ZipCode.lookup.findAll()
+----
+
+Criteria:
+
+[source,groovy]
+----
+ZipCode.lookup.createCriteria.list {}
+----