--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/liquibase.rst	Mon Dec 21 12:40:38 2015 +0200
@@ -0,0 +1,54 @@
+.. -*- coding: utf-8; -*-
+.. include:: HEADER.rst
+
+============
+ LiquiBase.
+============
+.. contents::
+
+Introducing LiquiBase to existing project.
+==========================================
+
+Official statement about introducing LiquiBase to existing project are:
+
+  http://www.liquibase.org/documentation/existing_project.html
+    Adding Liquibase on an Existing project
+
+There are two approaches:
+
+ * create full schema definition prior to introducing Liquibase
+ * works only with current changes becase Liquibase basically work only with changesets and only
+   special supplied instruments care about full schema definition
+
+To create full schema debinition you may run::
+
+  mvn liquibase:generateChangeLog -Dliquibase.outputChangeLogFile=...
+
+on clean project without Liquibase. Or set name for changelog output file in ``pom.xml``.
+(here reduced not fully worked declaration)::
+
+  <plugin>
+      <groupId>org.liquibase</groupId>
+      <artifactId>liquibase-maven-plugin</artifactId>
+      <version>${liquibase.version}</version>
+      <configuration>
+          <outputChangeLogFile>changelog.xml</outputChangeLogFile>
+      </configuration>
+  </plugin>
+
+.. NOTE::
+
+   ``pom.xml`` settings have precedence over ``-Dliquibase.outputChangeLogFile=...`` unless you
+   define it as::
+
+     <properties>
+         <liquibase.outputChangeLogFile>${project.build.directory}/changelog.xml</liquibase.outputChangeLogFile>
+     </properties>
+     <plugins>
+         <plugin>
+             <configuration>
+                 <outputChangeLogFile>${liquibase.outputChangeLogFile}</outputChangeLogFile>
+             </configuration>
+         </plugin>
+     </plugins>
+