enable autogeneration of docs using asciidoctor gradle plugin

Author: juancgalvis

build.gradle

@@ -13,6 +13,7 @@ buildscript {
 plugins {
     id 'jacoco'
     id "org.sonarqube" version "3.0"
+    id 'org.asciidoctor.jvm.convert' version '3.1.0'
 }
 
 sonarqube {
@@ -23,5 +24,18 @@ sonarqube {
     }
 }
 
+repositories {
+    jcenter()
+}
+
+asciidoctor {
+    sourceDir file('docs/asciidoc')
+    baseDir file('docs/asciidoc')
+    sources {
+        include 'index.asciidoc'
+    }
+    outputDir file('build/docs')
+}
+
 apply from: './main.gradle'
 apply plugin: 'com.github.ben-manes.versions'

docs/asciidoc/api-guide.adoc

@@ -219,6 +219,10 @@ Where the EventHandler interface signature is:
 --------
 public interface EventHandler<T> extends GenericHandler<Void, DomainEvent<T>> {
 }
+
+public interface GenericHandler<T, M> {
+    Mono<T> handle(M message);
+}
 --------
 
 [NOTE]
@@ -257,6 +261,10 @@ Where the CommandHandler interface signature is:
 --------
 public interface CommandHandler<T> extends GenericHandler<Void, Command<T>> {
 }
+
+public interface GenericHandler<T, M> {
+    Mono<T> handle(M message);
+}
 --------
 [NOTE]
 The return type of the CommandHandler is Void

docs/asciidoc/index.asciidoc

@@ -1,17 +1,17 @@
 = Reactive Commons Reference Guide
 Daniel Bustamante Ospina
 // version is automatically set in doc.gradle, no need to change it here
-:appversion: 0.6.2
+:appversion: 0.6.2-ignored-value
 ifndef::host-github[:ext-relative: {outfilesuffix}]
-{appversion}
 :doctype: book
-:toc:
+:toc: left
 :toclevels: 4
 :source-highlighter: prettify
 :numbered:
 :icons: font
 :hide-uri-scheme:
-:imagesdir: images
+:stylesheet: stylesheets/asciidoctor.css
+:linkcss:
 
 :github-repo: reactive-commons
 :github-code: https://github.com/{github-repo}
@@ -26,4 +26,4 @@ include::api-guide.adoc[]
 // ======================================================================================
 
 // Command to HTML export
-// asciidoctor -a linkcss -a stylesheet=asciidoctor.css -a toc2 -a stylesdir=./stylesheets index.asciidoc
+// asciidoctor -a linkcss -a stylesheet=asciidoctor.css -a toc2 -a stylesdir=./stylesheets index.asciidoc