diff --git a/.gitignore b/.gitignore
index c066a3907d58b565b4adcb4639e8ddea31ac7c4b..8e3a7fde5de1cf9444e4ae2ed0d4325cf1a50f05 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,2 @@
 inst/doc
+.Rproj.user
diff --git a/README.md b/README.md
index 9fabdcb2dcce833ef1b707bdfe23a137a37f0449..4b04e5f087e3a9c2b6420b5ae460c337a890a6d4 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,8 @@
-# gmGeostats
+# gmGeostats: Geostatistics for Compositional Analysis with R
+
+This R package offers support for geostatistical analysis of multivariate data, in particular data with restrictions, e.g. positive amounts data, compositional data, distributional data, microstructural data, etc. It includes descriptive analysis and modelling for such data, both from a two-point Gaussian perspective and multipoint perspective. The package is devised for supporting 3D, multi-scale and large data sets and grids. This is a building block of the suite of HIF geometallurgical software.
+
+## More information 
+
+Read the (./vignettes/gmGeostats.html)[vignette] for a scheme of the package functionality.