Jonas Fonseca

I will start looking at this over the coming weeks. Vladimir and I have discussed meeting in person if something blocks my progress. Thanks a lot @vsch for showing this...

If I understand correctly Paradox silently ignores the snip identifier. I believe this is somewhat related with #23 in the sense that invalid identifiers do not result in an error.

I suggest to configure the "next page" in the front matter of the Maven and sbt pages. This would allow to either implement it entirely in the theme or change...

Tut can be used by preprocessing Markdown files before running Paradox. Example when using sbt-site [here](http://www.scala-sbt.org/sbt-site/preprocess.html#preprocessing-markdown-files-with-tut) can be adapted to work directly with the Paradox sbt plugin.

When using Paradox with sbt-site everything is scoped using `Paradox` by default. So try something like this: ``` sourceDirectory in Paradox in paradoxTheme := sourceDirectory.value / "main" / "paradox" /...

The Paradox theme for the new Akka docs can be found here: https://github.com/akka/akka-paradox

#50 documents theming/templates. The generic theme doesn't separate the footer and header into separate templates, so that might be the quick fix to allow loading additional CSS and JS files....

Did you try to use source reference? ```md Please visit the [Slick documentation for `DatabaseConfig.fromConfig`][jdbcbackend-api] for the full list of things to configure. [jdbcbackend-api]: (http://slick.lightbend.com/doc/3.2.1/api/index.html#slick.jdbc.JdbcBackend$DatabaseFactoryDef@forConfig(String,Config,Driver,ClassLoader):Database) ```

The problem is that `com.typesafe.config.Config` is converted to `io.circe.Json` without knowing what will be the final type of the `"on"` string. As far as I know it is not possible...

It would be good to document this though so if you are up for making a PR that would be great else let's keep this issue open until that gets...