Improved documentation of assembly construction

Author: cboehme

pom.xml

@@ -222,12 +222,20 @@
 			<version>2.0.0-SNAPSHOT</version>
 		</dependency>
 
-		<dependency>
-			<groupId>org.slf4j</groupId>
-			<artifactId>slf4j-api</artifactId>
-			<version>1.7.6</version>
-		</dependency>
-
+		<!-- The following dependencies are placed in the "provided"
+		     scope to prevent them from being included in the class
+		     path but still have them available for building the
+		     distribution assembly. 
+		     The reason for this is that appropriate implementations 
+		     for slf4j and jndi depend on the runtime environment and 
+		     should be chosen by the user of the package and not the 
+		     package implementer. However, since we are not also 
+		     building a distribution package which should include 
+		     everything that is required for metafacture-runner/Flux 
+		     to work out of the box. By including the dependencies 
+		     in the assembly without putting them on the class path, 
+		     the user can replace them easily with other 
+		     implementations if necessary. -->
 		<dependency>
 			<groupId>org.slf4j</groupId>
 			<artifactId>slf4j-log4j12</artifactId>
@@ -243,6 +251,7 @@
 		</dependency>
 
 		<dependency>
+			<!-- Required for connection pooling with simple-jndi -->
 			<groupId>commons-dbcp</groupId>
 			<artifactId>commons-dbcp</artifactId>
 			<version>1.4</version>