Bump the version and add documentation.

Author: jcustenborder

docs/introduction.rst

@@ -0,0 +1,42 @@
+================
+Splunk Connector
+================
+
+The Splunk Connector provides a :term:`Source Connector` that emulates a Splunk HEC endpoint and a :term:`Source Connector`
+that can be used to write data to a Splunk HEC endpoint.
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Source Connectors:
+    :hidden:
+    :glob:
+
+    sources/*
+
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Sink Connectors:
+    :hidden:
+    :glob:
+
+    sinks/*
+
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Transformations:
+    :hidden:
+    :glob:
+
+    transformations/*
+
+
+.. toctree::
+    :maxdepth: 0
+    :caption: Schemas:
+    :hidden:
+
+    schemas
+
+

pom.xml

@@ -23,7 +23,7 @@
     <parent>
         <groupId>com.github.jcustenborder.kafka.connect</groupId>
         <artifactId>kafka-connect-parent</artifactId>
-        <version>0.10.2.0-cp1</version>
+        <version>0.10.2.1-cp1</version>
     </parent>
     <artifactId>kafka-connect-splunk</artifactId>
     <version>0.2.0-SNAPSHOT</version>

src/main/java/com/github/jcustenborder/kafka/connect/splunk/SplunkHttpSinkConnector.java

@@ -28,7 +28,7 @@
 import java.util.Map;
 
 @Description("The Sink Connector will transform data from a Kafka topic into a batch of json messages that will be written via HTTP to " +
-    "a configured [Splunk Http Event Collector](http://dev.splunk.com/view/event-collector/SP-CAAAE6M).")
+    "a configured `Splunk Http Event Collector` <http://dev.splunk.com/view/event-collector/SP-CAAAE6M>`.")
 public class SplunkHttpSinkConnector extends SinkConnector {
   private static Logger log = LoggerFactory.getLogger(SplunkHttpSinkConnector.class);
   Map<String, String> settings;

src/main/java/com/github/jcustenborder/kafka/connect/splunk/SplunkHttpSourceConnector.java

@@ -17,6 +17,7 @@
 
 import com.github.jcustenborder.kafka.connect.utils.VersionUtil;
 import com.github.jcustenborder.kafka.connect.utils.config.Description;
+import com.github.jcustenborder.kafka.connect.utils.config.DocumentationImportant;
 import org.apache.kafka.common.config.ConfigDef;
 import org.apache.kafka.connect.connector.Task;
 import org.apache.kafka.connect.source.SourceConnector;
@@ -25,10 +26,13 @@
 import java.util.List;
 import java.util.Map;
 
-@Description("The Splunk Source connector allows emulates a [Splunk Http Event Collector](http://dev.splunk.com/view/event-collector/SP-CAAAE6M) to allow " +
+@Description("The Splunk Source connector allows emulates a `Splunk Http Event Collector` <http://dev.splunk.com/view/event-collector/SP-CAAAE6M> to allow " +
     "application that normally log to Splunk to instead write to Kafka. The goal of this plugin is to make the change nearly " +
-    "transparent to the user. This plugin currently has support for [X-Forwarded-For](https://en.wikipedia.org/wiki/X-Forwarded-For) so " +
+    "transparent to the user. This plugin currently has support for `X-Forwarded-For <https://en.wikipedia.org/wiki/X-Forwarded-For>` so " +
     "it will sit behind a load balancer nicely.")
+@DocumentationImportant("This connector listens on a network port. Running more than one task or running in distributed " +
+    "mode can cause some undesired effects if another task already has the port open. It is recommended that you run this " +
+    "connector in :term:`Standalone Mode`.")
 public class SplunkHttpSourceConnector extends SourceConnector {
   Map<String, String> settings;
   private SplunkHttpSourceConnectorConfig config;