Richard Imaoka

Document how to keep running an akka-http server in production

12

There was a feedback in Twitter. https://twitter.com/brianclapper/status/917148072718798848 >those past techniques aren’t working w/ this version of Akka HTTP. Documentation for non-toy cases would be awesome. ;-) https://twitter.com/jlprat/status/917149279399108608 >Agree, readLine is...

Javadoc directive for a method links to the class page, not the method section of the page

1

http://developer.lightbend.com/docs/paradox/latest/features/linking.html#javadoc-directive The doc says : `@javadoc[Http](akka.http.javadsl.Http#shutdownAllConnectionPools--)` will resolve to http://doc.akka.io/japi/akka-http/10.0.0/akka/http/javadsl/Http.html#shutdownAllConnectionPools--. _(it jumps to the **method section** of the class page)_ however, it actually doesn't. I tried it in [my test...

If you have an invalid directive in .md, like `@nosuchdirective[Whatever]`, it just generates an empty `` without any exception. I believe it should thrown an exception instead - since wrong...

Directive to include reference.conf info in documentation

3

Copying the description from: https://github.com/akka/akka/issues/24965 --------- It might be neat if we could create a paradox directive that finds the relevant entry in the reference.conf and includes it, including default...