Move comparison to other languages to vignette

Zedseayou · Mar 21, 2017 · 011e690 · 011e690
1 parent 34147b5
commit 011e690
Show file tree

Hide file tree

Showing 50 changed files with 310 additions and 103 deletions.
diff --git a/.gitignore b/.gitignore
@@ -1,3 +1,4 @@
 .Rproj.user
 .Rhistory
 .RData
+inst/doc
diff --git a/DESCRIPTION b/DESCRIPTION
@@ -19,7 +19,10 @@ Suggests:
     covr,
     dplyr (>= 0.4.3),
     testthat,
-Remotes: 
+    knitr,
+    rmarkdown
+Remotes:
     hadley/rlang
 RoxygenNote: 6.0.1
 Roxygen: list(markdown = TRUE)
+VignetteBuilder: knitr
diff --git a/README.Rmd b/README.Rmd
@@ -61,42 +61,3 @@ This example illustrates some of the advantages of purrr functions over the equi
 * All `map()` functions either accept function, formulas (used for succinctly
   generating anonymous functions), a character vector (used to extract 
   components by name), or a numeric vector (used to extract by position).
-
-## Philosophy
-
-The goal is not to try and simulate Haskell in R: purrr does not implement currying or destructuring binds or pattern matching. The goal is to give you similar expressiveness to an FP language, while allowing you to write code that looks and works like R.
-
-* Instead of point free style, use the pipe, `%>%`, to write code that can be
-  read from left to right.
-
-* Instead of currying, we use `...` to pass in extra arguments.
-
-* Anonymous functions are verbose in R, so we provide two convenient shorthands.
-  For unary functions, `~ .x + 1` is equivalent to `function(.x) .x + 1`.
-  For chains of transformations functions, `. %>% f() %>% g()` is
-  equivalent to `function(.) . %>% f() %>% g()`.
-
-* R is weakly typed, we need variants `map_int()`, `map_dbl()`, etc since we 
-  don't know what `.f` will return.
-
-* R has named arguments, so instead of providing different functions for
-  minor variations (e.g. `detect()` and `detectLast()`) I use a named
-  argument, `.right`. Type-stable functions are easy to reason about so
-  additional arguments will never change the type of the output.
-
-## Related work
-
-* [rlist](http://renkun.me/rlist/), another R package to support working
-  with lists. Similar goals but somewhat different philosophy.
-
-* Functional programming librarys for javascript: 
-  [underscore.js](http://underscorejs.org), 
-  [lodash](https://lodash.com) and 
-  [lazy.js](http://danieltao.com/lazy.js/).
-
-* List operations defined in the Haskell [prelude][haskell]
-
-* Scala's [list methods][scala].
-
-[scala]:http://www.scala-lang.org/api/current/index.html#scala.collection.immutable.List
-[haskell]:http://hackage.haskell.org/package/base-4.7.0.1/docs/Prelude.html#g:11
diff --git a/README.md b/README.md
@@ -49,29 +49,3 @@ This example illustrates some of the advantages of purrr functions over the equi
 -   All purrr functions are type-stable. They always return the advertised output type (`map()` returns lists; `map_dbl()` returns double vectors), or they throw an errror.
 
 -   All `map()` functions either accept function, formulas (used for succinctly generating anonymous functions), a character vector (used to extract components by name), or a numeric vector (used to extract by position).
-
-Philosophy
-----------
-
-The goal is not to try and simulate Haskell in R: purrr does not implement currying or destructuring binds or pattern matching. The goal is to give you similar expressiveness to an FP language, while allowing you to write code that looks and works like R.
-
--   Instead of point free style, use the pipe, `%>%`, to write code that can be read from left to right.
-
--   Instead of currying, we use `...` to pass in extra arguments.
-
--   Anonymous functions are verbose in R, so we provide two convenient shorthands. For unary functions, `~ .x + 1` is equivalent to `function(.x) .x + 1`. For chains of transformations functions, `. %>% f() %>% g()` is equivalent to `function(.) . %>% f() %>% g()`.
-
--   R is weakly typed, we need variants `map_int()`, `map_dbl()`, etc since we don't know what `.f` will return.
-
--   R has named arguments, so instead of providing different functions for minor variations (e.g. `detect()` and `detectLast()`) I use a named argument, `.right`. Type-stable functions are easy to reason about so additional arguments will never change the type of the output.
-
-Related work
-------------
-
--   [rlist](http://renkun.me/rlist/), another R package to support working with lists. Similar goals but somewhat different philosophy.
-
--   Functional programming librarys for javascript: [underscore.js](http://underscorejs.org), [lodash](https://lodash.com) and [lazy.js](http://danieltao.com/lazy.js/).
-
--   List operations defined in the Haskell [prelude](http://hackage.haskell.org/package/base-4.7.0.1/docs/Prelude.html#g:11)
-
--   Scala's [list methods](http://www.scala-lang.org/api/current/index.html#scala.collection.immutable.List).
diff --git a/docs/articles/other-langs.html b/docs/articles/other-langs.html
diff --git a/docs/authors.html b/docs/authors.html
diff --git a/docs/index.html b/docs/index.html
diff --git a/docs/reference/accumulate.html b/docs/reference/accumulate.html
diff --git a/docs/reference/along.html b/docs/reference/along.html
diff --git a/docs/reference/array-coercion.html b/docs/reference/array-coercion.html
diff --git a/docs/reference/as_mapper.html b/docs/reference/as_mapper.html
diff --git a/docs/reference/as_vector.html b/docs/reference/as_vector.html
diff --git a/docs/reference/compose.html b/docs/reference/compose.html
diff --git a/docs/reference/cross.html b/docs/reference/cross.html
diff --git a/docs/reference/depth.html b/docs/reference/depth.html
diff --git a/docs/reference/detect.html b/docs/reference/detect.html
diff --git a/docs/reference/every.html b/docs/reference/every.html