Improvement documentation

[ahojukka5]

Yesterday brainstorming with @TeroFrondelius.

• "organization" front page (static), with all projects described
• all packages in left side menu linking to the package documentation

Practical issues? Separate repo for front page?

See http://www.juliadiff.org to get ideas, they have separate repo for front page.

[TeroFrondelius]

Here is sphinx-julia package:
https://groups.google.com/forum/m/#!topic/julia-users/MIouqlzywsY

https://github.com/bastikr/sphinx-julia

[ahojukka5]

Maybe we should try Documenter.jl. We already own juliafem.org but we need some place where we host our documentation. Github Pages is one option, another one is ReadTheDocs.

We need some special things if we want to convert Jupyter Notebooks to part of documentation as planned and not sure how to get everything set up without a virtual machine or similar.

[TeroFrondelius]

Here are few solutions to process Jupyter notebooks:
https://discourse.julialang.org/t/blogging-with-julia-code-blocks/2419

[TeroFrondelius]

Maybe this is relevant: https://help.github.com/articles/configuring-a-publishing-source-for-github-pages/

[ahojukka5]

We now have https://juliafem.github.io which is run based on Jekyll. I opened issue there about writing pages using notebooks, so we can close this now.