diff --git a/.gitignore b/.gitignore
index 8f5fa99ae77285dbdf89d91ec5dca619bdf07d2e..32358936d0b933fa577bc062610396a386202048 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,5 @@
 # ignore pdf files
 *.pdf
+
+# ignore build r package:
+sybil_*.tar.gz
diff --git a/README.md b/README.md
index 3f745fa825bcf0489879201ff61423b64ddd8f89..901c9d0fb81f91fe83715270d29ff00e06e78df2 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,8 @@
-sybil
-=====
+#sybil - Efficient Constrained Based Modelling in R
 
-sybil - Efficient Constrained Based Modelling in R
+The package sybil is a Systems Biology Library for R, implementing algorithms for constraint based analyses of metabolic networks (e.g. flux-balance analysis (FBA), minimization of metabolic adjustment (MOMA), regulatory on/off minimization (ROOM), robustness analysis and flux variability analysis).
+
+Please consider downloading and installing the package via the R internal package management:
+install.packages("sybil")
+
+Alternatively you can visit the [CRAN pakage website](http://cran.r-project.org/web/packages/sybil/index.html).