Add docs with Documenter. (#35)

Author: Sam Morrison

.gitignore

@@ -1,3 +1,5 @@
 *.jl.cov
 *.jl.*.cov
 *.jl.mem
+/docs/build/
+/docs/Manifest.toml

.travis.yml

@@ -7,6 +7,7 @@ os:
 julia:
   - 0.6
   - 0.7
+  - 1.0
   - nightly
 
 # # Uncomment the following lines to allow failures on nightly julia
@@ -23,5 +24,16 @@ notifications:
 #  - julia -e 'Pkg.clone(pwd()); Pkg.build("Example"); Pkg.test("Example"; coverage=true)';
 
 after_success:
-  - julia -e 'cd(Pkg.dir("Example")); Pkg.add("Coverage"); using Coverage; Coveralls.submit(Coveralls.process_folder())';
-#  - julia -e 'cd(Pkg.dir("Example")); Pkg.add("Coverage"); using Coverage; Codecov.submit(Codecov.process_folder())';
+  - julia -e 'if VERSION >= v"0.7.0-" using Pkg end; cd(Pkg.dir("Example")); Pkg.add("Coverage"); using Coverage; Coveralls.submit(Coveralls.process_folder())';
+#  - julia -e 'if VERSION >= v"0.7.0-" using Pkg end; cd(Pkg.dir("Example")); Pkg.add("Coverage"); using Coverage; Codecov.submit(Codecov.process_folder())';
+
+jobs:
+  include:
+    - stage: "Documentation"
+      julia: 1.0
+      os: linux
+      script:
+        - julia --project=docs/ -e 'using Pkg; Pkg.instantiate();
+                                    Pkg.develop(PackageSpec(path=pwd()))'
+        - julia --project=docs/ docs/make.jl
+      after_success: skip

README.md

@@ -2,6 +2,8 @@ Example Julia package repo.
 
 [![Example](http://pkg.julialang.org/badges/Example_0.6.svg)](http://pkg.julialang.org/?pkg=Example)
 [![Example](http://pkg.julialang.org/badges/Example_0.7.svg)](http://pkg.julialang.org/?pkg=Example)
+[![](https://img.shields.io/badge/docs-stable-blue.svg)](https://JuliaLang.github.io/Example.jl/stable)
+[![](https://img.shields.io/badge/docs-dev-blue.svg)](https://JuliaLang.github.io/Example.jl/dev)
 
 Linux and macOS: [![Build Status](https://travis-ci.org/JuliaLang/Example.jl.svg?branch=master)](https://travis-ci.org/JuliaLang/Example.jl)
 

docs/Project.toml

@@ -0,0 +1,5 @@
+[deps]
+Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
+
+[compat]
+Documenter = "~0.20"

docs/make.jl

@@ -0,0 +1,7 @@
+using Documenter, Example
+
+makedocs(modules = [Example], sitename = "Example.jl")
+
+deploydocs(
+    repo = "github.com/JuliaLang/Example.jl.git",
+)

docs/src/index.md

@@ -0,0 +1,7 @@
+# Example
+
+Example Julia package repo.
+
+```@autodocs
+Modules = [Example]
+```

src/Example.jl

@@ -1,7 +1,18 @@
 module Example
 export hello, domath
 
+"""
+    hello(who::String)
+
+Return "Hello, `who`".
+"""
 hello(who::String) = "Hello, $who"
+
+"""
+    domath(x::Number)
+
+Return `x + 5`.
+"""
 domath(x::Number) = x + 5
 
 end