Port manual to Documenter

Move all content to docstrings when they were missing or incomplete.
Fix many details in docstrings. Improve in particular docstrings
for sampling algorithms, analysis of signals, and stats models.

.travis.yml

@@ -16,3 +16,5 @@ git:
 #  - julia -e 'Pkg.clone(pwd()); Pkg.build("StatsBase"); Pkg.test("StatsBase"; coverage=true)'
 after_success:
   - julia -e 'cd(Pkg.dir("StatsBase")); Pkg.add("Coverage"); using Coverage; Coveralls.submit(Coveralls.process_folder())'
+  - julia -e 'Pkg.add("Documenter")'
+  - julia -e 'cd(Pkg.dir("StatsBase")); include(joinpath("docs", "make.jl"))'

README.md

@@ -9,4 +9,10 @@
   [![Build Status](https://travis-ci.org/JuliaStats/StatsBase.jl.svg?branch=master)](https://travis-ci.org/JuliaStats/StatsBase.jl)
   [![Coverage Status](https://coveralls.io/repos/JuliaStats/StatsBase.jl/badge.svg?branch=master)](https://coveralls.io/r/JuliaStats/StatsBase.jl?branch=master)
 
-- **Documentation:** [![Documentation Status](https://readthedocs.org/projects/statsbasejl/badge/?version=latest)](https://readthedocs.org/projects/statsbasejl/?badge=latest) <http://statsbasejl.readthedocs.org/en/latest/>
+- **Documentation**: [![][docs-stable-img]][docs-stable-url] [![][docs-latest-img]][docs-latest-url]
+
+[docs-latest-img]: https://img.shields.io/badge/docs-latest-blue.svg
+[docs-latest-url]: http://JuliaStats.github.io/StatsBase.jl/latest/
+
+[docs-stable-img]: https://img.shields.io/badge/docs-stable-blue.svg
+[docs-stable-url]: http://JuliaStats.github.io/StatsBase.jl/stable/

docs/make.jl

@@ -0,0 +1,32 @@
+using Documenter, StatsBase
+
+makedocs(
+    format = :html,
+    sitename = "StatsBase.jl",
+    # options
+    modules = [StatsBase],
+    pages = ["index.md",
+             "weights.md",
+             "means.md",
+             "scalarstats.md",
+             "robust.md",
+             "deviation.md",
+             "cov.md",
+             "counts.md",
+             "ranking.md",
+             "sampling.md",
+             "empirical.md",
+             "signalcorr.md",
+             "misc.md",
+             "statmodels.md"]   
+)
+
+deploydocs(
+    # options
+    repo = "github.com/JuliaStats/StatsBase.jl.git",
+    target = "build",
+    julia  = "nightly",
+    osname = "linux",
+    deps = nothing,
+    make = nothing
+)