STYLE: add .gitignore and README

.gitignore

+# git-ls-files --others --exclude-from=.git/info/exclude
+# Lines that start with '#' are comments.
+
+# Editor and misc backup files - anywhere
+*~
+.*~
+*.bak
+*.bak[0-9][0-9]
+\#*\#
+
+# File-browser settings - anywhere
+.directory
+
+# CVS recovered versions - anywhere
+.#*
+
+# Objects and archives - anywhere
+*.[oa]
+*.la
+*.so
+
+# Derived files
+lex.yy.c
+
+# Corefiles
+core
+
+# Dependency files - anywhere
+*.dep
+
+# lnInclude (symlink) directories - anywhere
+lnInclude
+
+# Build directories - anywhere
+linux*Clang*/
+linux*Gcc*/
+linux*Icc*/
+solaris*Gcc*/
+SunOS*Gcc*/
+platforms/
+
+# Top-level build directories
+/build/
+/platforms/
+
+# Reinstate wmake rules that might look like build directories
+!/wmake/rules/*/
+
+# doxygen generated documentation
+doc/Doxygen/html
+doc/Doxygen/latex
+doc/Doxygen/man
+doc/Doxygen/DTAGS
+
+# Generated files in the main directory (e.g. ReleaseNotes-?.?.html)
+# and in the doc directory
+/*.html
+/doc/*.html
+
+# Untracked configuration files
+/etc/prefs.csh
+/etc/prefs.sh
+/etc/config.csh/prefs.csh
+/etc/config.sh/prefs.sh
+/wmake/rules/General/mplibUSER*
+
+# Source packages - anywhere
+*.tar.bz2
+*.tar.gz
+*.tar.xz
+*.tar
+*.tgz
+*.gtgz
+
+# Ignore the persistent .build tag in the main directory
+/.build
+
+# Ignore .timeStamp in the main directory
+/.timeStamp
+
+# Ignore .tags in the main directory
+/.tags
+
+# Ignore project files in the main directory
+/.cproject
+/.project
+/.dir-locals.el
+
+# Ignore the test directory
+/tutorialsTest

README

+What:
+
+    Library, solver and utilities for avalanche modelling using finiteArea.
+
+Author:
+
+    Matthias Rauter <matthias.rauter@uibk.ac.at>
+
+    who kindly supplied and ported the code from the original
+    implementation using foam-extend to OpenFOAM-1712.
+
+License:
+
+    Same terms as OpenFOAM.
+    Licensed under GNU General Public License <http://www.gnu.org/licenses/>.
+