Update documentation

[kornilova203]

What will be a proper way to deploy documentation?
One option is to use github pages but pushing generated htmls and other files to the repo does not look good to me.
Closes #96

[kornilova203]

It should be something like s"https://github.com/kornilova-l/scala-native-bindgen/tree/v${version.value}"
But what will be the way to release new version then?

• manually change version := "0.2-SNAPSHOT" to version := "0.2"
• generate docs
• release
• manually change version := "0.2" to version := "0.3-SNAPSHOT"

Is there a way to automate this?

[kornilova203]

I found out that it is also possible to push generated docs to gh-pages branch

[kornilova203]

Documentation can be found here https://kornilova-l.github.io/scala-native-bindgen/
Currently I build and update it manually but I suppose it is possible to write travis script that will do it automatically.

[jonas]

What was the reason to switch from Paradox to GitBook? Was it problem with configuration or something else? I personally think Paradox is a better fit since it has better indexing capabilities and because GitBook seems to have gone closed source.

For publishing we can use sbt-site with sbt-ghpages: https://www.scala-sbt.org/sbt-site/publishing.html#publishing-to-github-pages-using-sbt-ghpages

[kornilova203]

No particular reason except that GitBook has github-like rendering, I moved back to Paradox
sbt-ghpages works 👍

[jonas]

Awesome work with the tutorial.

[jonas]

This is no longer needed.