diff --git a/DESCRIPTION b/DESCRIPTION
index e24c7d18f689b7d2ffad8e9a4fd63507b4936d26..c8c311ed762ce239197c8df374eb0e204de6b24e 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -2,8 +2,8 @@ Package: LifeInsuranceContracts
 Type: Package
 Version: 0.0.1
 Date: 2020-09-04
-Title: A framework for general, traditional life insurance contracts, including profit
-    participation and contract changes
+Title: A Framework for General, Traditional Life Insurance Contracts, Including Profit
+    Participation and Contract Changes
 Description: R6 classes to model traditional life insurance
     contracts like annuities, whole life insurances or endowments. All relevant
     quantities like premium decomposition, reserves and benefits over the whole
@@ -19,9 +19,9 @@ Imports:
     objectProperties,
     lubridate,
     openxlsx,
-    abind,
     dplyr,
     scales,
+    abind,
     stringr,
     methods,
     rlang
@@ -51,3 +51,4 @@ VignetteBuilder: knitr
 Roxygen: list(markdown = TRUE)
 URL: https://gitlab.open-tools.net/R/r-life-insurance-contracts
 BugReports: https://gitlab.open-tools.net/R/r-life-insurance-contracts/-/issues
+"
diff --git a/R/HelperFunctions.R b/R/HelperFunctions.R
index 9420f1899348f74bff58859c02e8bf02d6083e1e..7dc0be10e91c1d7c8da2e8455488255706101ee9 100644
--- a/R/HelperFunctions.R
+++ b/R/HelperFunctions.R
@@ -129,7 +129,7 @@ mergeValues3D = function(starting, ending, t) {
   } else if (t == 0) {
     ending
   } else {
-    abind(starting[1:t,,], ending[-1:-t,,], along = 1)
+    abind::abind(starting[1:t,,], ending[-1:-t,,], along = 1)
   }
 }
 # Caution: px is not neccessarily 1-qx, because we might also have dread diseases so that px=1-qx-ix! However, the ix is not used for the survival present value
diff --git a/R/InsuranceContract.R b/R/InsuranceContract.R
index 29427506a705f2cccf4c76c726adae30493e4146..fc3a6cc117204478bf7d70d6bc79dab9dada618c 100644
--- a/R/InsuranceContract.R
+++ b/R/InsuranceContract.R
@@ -32,7 +32,7 @@ NULL
 #' # Calculation approach: Valuation
 #'
 #' The calculation of all contract values is controlled by the function
-#' \ifelse{html}{\href{method-calculateContract}{\code{InsuranceContract$calculateContract()}}}{\code{InsuranceContract$calculateContract()()}} (using methods of the [InsuranceTarif]
+#' \ifelse{html}{\href{#method-calculateContract}{\code{InsuranceContract$calculateContract()}}}{\code{InsuranceContract$calculateContract()()}} (using methods of the [InsuranceTarif]
 #' object) and follows the following logic:
 #'
 #' 1. First the **contingent (unit) cash flows** and the **transition probbilities**
diff --git a/README.md b/README.md
index fbc5300553aaf85f478d2cad1f4b8bfbf9544a99..b96611f2849df091967b4b44c1d36bbabf6668b4 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,8 @@
-# r-life-insurance-contracts
-R package implementing general insurance contracts
+# The *LifeInsuranceContracts* Package For Traditional Life Insurance with Guarantee and Profit Participation
+R package implementing general life insurance contracts
+
+This package R6 classes to model traditional life insurance
+    contracts like annuities, whole life insurances or endowments. All relevant
+    quantities like premium decomposition, reserves and benefits over the whole
+    contract period are calculated and potentially exported to excel. Mortalities
+    are given using the MortalityTables package.
diff --git a/man/InsuranceContract.Rd b/man/InsuranceContract.Rd
index 3bad207ce77485abe06ae52abbcd859e0f537f1c..e952c143ebfa0dbf36e0073039facaa2d2096b30 100644
--- a/man/InsuranceContract.Rd
+++ b/man/InsuranceContract.Rd
@@ -30,7 +30,7 @@ field of the object.
 
 \section{Calculation approach: Valuation}{
 The calculation of all contract values is controlled by the function
-\ifelse{html}{\href{method-calculateContract}{\code{InsuranceContract$calculateContract()}}}{\code{InsuranceContract$calculateContract()()}} (using methods of the \link{InsuranceTarif}
+\ifelse{html}{\href{#method-calculateContract}{\code{InsuranceContract$calculateContract()}}}{\code{InsuranceContract$calculateContract()()}} (using methods of the \link{InsuranceTarif}
 object) and follows the following logic:
 \enumerate{
 \item First the \strong{contingent (unit) cash flows} and the \strong{transition probbilities}
diff --git a/vignettes/using-the-lifeinsurancecontracts-package.Rmd b/vignettes/using-the-lifeinsurancecontracts-package.Rmd
index 7e2976e6ed94843c7c93a7d2de0f38339500c1fc..2f196c0951946f4d92839d2b2679e5f62addf32f 100644
--- a/vignettes/using-the-lifeinsurancecontracts-package.Rmd
+++ b/vignettes/using-the-lifeinsurancecontracts-package.Rmd
@@ -1512,7 +1512,7 @@ lapply(blk, function(b) {
 In addition to the above guaranteed values, many contracts also include some 
 kind of profit sharing. The total amount of money to be distributed is usually
 predetermined by law or regulation (in Austria by the
-[https://www.ris.bka.gv.at/GeltendeFassung.wxe?Abfrage=Bundesnormen&Gesetzesnummer=20009295]("Lebensversicherung-Gewinnbeteiligungsverordnung -- LV-GBV")), 
+["Lebensversicherung-Gewinnbeteiligungsverordnung -- LV-GBV"](https://www.ris.bka.gv.at/GeltendeFassung.wxe?Abfrage=Bundesnormen&Gesetzesnummer=20009295), 
 but the actual way they are distributed to individual contracts is up the
 insurance undertaking. The profit participation scheme defines profit participation
 allocations based on certain rates and bases, where the formulas and the types