Port manual to Documenter (#275)

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.

.gitignore

@@ -1,2 +1,3 @@
 docs/build
+docs/site
 perf/*.csv

.travis.yml

@@ -17,3 +17,4 @@ 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"); 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,27 @@
+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(
+    repo = "github.com/JuliaStats/StatsBase.jl.git",
+    julia  = "0.6"
+)