diff --git a/R/pkg.R b/R/pkg.R
index de35a9e..83fa8ff 100644
--- a/R/pkg.R
+++ b/R/pkg.R
@@ -10,7 +10,7 @@
 #' Mustache (and therefore \code{whisker}) takes a simple but different approach to templating compared to 
 #' most templating engines. Most templating libraries for example \code{Sweave} and \code{brew} allow the user
 #' to mix programming code and text throughout the template. This is powerful, but ties a template directly
-#' to a programming language. Furthermore that approach makes it difficult to seperate programming code 
+#' to a programming language. Furthermore that approach makes it difficult to separate programming code 
 #' from templating code.
 #'
 #' Whisker on the other hand, takes a Mustache template and uses the variables of the current environment (or the
diff --git a/R/whisker.R b/R/whisker.R
index 63d2931..c166030 100644
--- a/R/whisker.R
+++ b/R/whisker.R
@@ -4,14 +4,14 @@
 #' @param data named \code{list} or \code{environment} with variables that will be used during rendering
 #' @param partials named \code{list} with partial templates, will be used during template construction
 #' @param debug Used for debugging purposes, likely to disappear
-#' @param strict \code{logical} if \code{TRUE} the seperation symbol is a "." otherwise a "$"
+#' @param strict \code{logical} if \code{TRUE} the separation symbol is a "." otherwise a "$"
 #' @return \code{character} with rendered template
 #' @rdname whisker.render
 #' @example examples/whisker_render.R
 #' @export
 #' @note 
 #' By default whisker applies html escaping on the generated text. 
-#' To prevent this use \{\{\{variable\}\}\} (triple) in stead of 
+#' To prevent this use \{\{\{variable\}\}\} (triple) instead of 
 #' \{\{variable\}\}.
 whisker.render <- function( template
                           , data = parent.frame()
diff --git a/README.rmd b/README.rmd
index bc8f657..1d3e2ef 100644
--- a/README.rmd
+++ b/README.rmd
@@ -3,7 +3,7 @@
 Whisker
 =======
 
-Whisker is a [{{Mustache}}](http://mustache.github.com) implementation in 
+Whisker is a [{{Mustache}}](https://mustache.github.io/) implementation in 
 [R](http://www.r-project.org/) confirming to the Mustache specification.
 Mustache is a logicless templating language, meaning that no programming source
 code can be used in your templates. This may seem very limited, but Mustache is 
@@ -16,7 +16,7 @@ Mustache (and therefore whisker) takes a simple, but different, approach to
 templating compared to most templating engines. Most templating libraries, 
 such as `Sweave`, `knitr` and `brew`, allow the user to mix programming code and text 
 throughout the template. This is powerful, but ties your template directly
-to a programming language and makes it difficult to seperate programming code from 
+to a programming language and makes it difficult to separate programming code from 
 templating code.
 
 Whisker, on the other hand, takes a Mustache template and uses the variables of the 
@@ -30,8 +30,8 @@ How the mustache template are used with whisker can be found in the whisker docu
 
 Mustache specification
 ----------------------
-Whisker conforms to the [Mustache 1.1 specificaton](https://github.com/mustache/spec) except for delimiter switching and
-lambdas. We expect that these will be implented shortly.
+Whisker conforms to the [Mustache 1.1 specification](https://github.com/mustache/spec) except for delimiter switching and
+lambdas. We expect that these will be implemented shortly.
 
 Installation
 ============
@@ -42,19 +42,19 @@ To install whisker use the following statement in your R console
 install.packages("whisker")
 ```
 
-The latest whisker version is not yet available on CRAN, but can be installed from github:
+The latest whisker version is not yet available on CRAN, but can be installed from GitHub:
 
 ```r
 library(devtools)
 
 # dev_mode()
-install_github("whisker", "edwindj")
+install_github("edwindj/whisker")
 ```
 
 Usage
 -----
 
-`whisker.render` accepts a `character` template and a list or environment containing data to render:
+`whisker.render()` accepts a `character` template and a list or environment containing data to render:
 
 ```{r tidy=FALSE}
 library(whisker)
@@ -94,6 +94,6 @@ writeLines(whisker.render(template, data), "./output.html")
 Note
 ----
 
-By default `whisker` applies `html` escaping on the generated text.
-To prevent this use "{{{variable}}}" (triple) in stead of "{{variable}}".
+By default whisker applies html escaping on the generated text.
+To prevent this use "{{{variable}}}" (triple) instead of "{{variable}}" (double).