replace lexicon.jl with documenter.jl for generating docs.

[OkonSamuel]

According to Lexicon.jl Documentation generation using Docile.jl and Lexicon.jl is being deprecated in Julia 0.4 and above in favour of Documenter.jl.

[cstjean]

Yes! The docs are very much in need of a refresh. In fact, the notebooks should be converted into either Weave.jl or Literate.jl

[OkonSamuel]

@cstjean. There is one issue in converting the notebooks to weave or Literate.jl.

• weave only supports Plots.jl plots
• Literate doesn't yet support capturing plots

[OkonSamuel]

my plan is to use those notebooks as input and weave them to markdown in the doc generation process into a folder. Then finally add them to documenter

[cstjean]

That sounds good, too. I've never worked with either weave or literate; I just heard that it was superior to notebooks for docs. Which makes some sense. It's certainly better for git tracking.

We could redo the plots in Plots.jl too. That's obviously significant work, but it might be good to introduce new users to it rather than matplotlib.

[OkonSamuel]

@cstjean. OK I guess I will work on that later. But for now can we tag a new release ??

[cstjean]

Sure! Feel free to tag whenever you judge it's appropriate.