From 2887b292b2e0e0778c578d51e0bfebecac21873d Mon Sep 17 00:00:00 2001
From: Beatrix Becker <beatrix.becker@iws.uni-stuttgart.de>
Date: Thu, 13 Dec 2018 11:32:48 +0100
Subject: [PATCH] [handbook] Introduce to 3.0 and add link to wiki

---
 doc/handbook/1_introduction.tex | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/doc/handbook/1_introduction.tex b/doc/handbook/1_introduction.tex
index c07a5787d6..370786c3f5 100644
--- a/doc/handbook/1_introduction.tex
+++ b/doc/handbook/1_introduction.tex
@@ -74,3 +74,17 @@ spatial and temporal discretization schemes as well as nonlinear solvers,
 to general concepts for model coupling.
 Moreover, \Dumux includes ready to use numerical models and a few example applications.
 
+This is the handbook to a new major version update of \Dumux: version 3.0.
+The release contains considerable improvements and many new features compared to the 2.x versions. 
+Due to the major update, backwards compatibility with the last release 2.12 cannot be assured.
+To facilitate the transition for our users, we have created a
+git wiki entry describing how to update programs from version 2.12 to version 3.0.
+It is available online:
+\url{https://git.iws.uni-stuttgart.de/dumux-repositories/dumux/wikis/Updating-programs-from-version-2.12-to-version-3.0}.
+The guide leads in detail through the interface changes from 2.12 to 3.0,
+concerning the \texttt{Problem} class, the \texttt{SpatialParams} class,
+the \texttt{Parameters} and \texttt{Properties}, i.e. the main user interface.
+Starting with version 3.0.0, all minor
+version updates will certainly be backward compatible again with at least the last minor version.
+We highly recommend all our users to transition with us to \Dumux-3.0
+and wish everyone a brand-new and exciting simulation experience.
-- 
GitLab