added some javadoc

Author: Mark

src/main/java/com/arangodb/ArangoDBAsync.java

@@ -219,10 +219,22 @@ public void shutdown() {
 		executor.communication().disconnect();
 	}
 
+	/**
+	 * Returns a handler of the system database
+	 * 
+	 * @return database handler
+	 */
 	public ArangoDatabaseAsync db() {
 		return db(ArangoDBConstants.SYSTEM);
 	}
 
+	/**
+	 * Returns a handler of the database by the given name
+	 * 
+	 * @param name
+	 *            Name of the database
+	 * @return database handler
+	 */
 	public ArangoDatabaseAsync db(final String name) {
 		return new ArangoDatabaseAsync(this, name);
 	}
@@ -373,6 +385,14 @@ public CompletableFuture<UserEntity> replaceUser(final String user, final UserUp
 		return executor.execute(replaceUserRequest(db().name(), user, options), UserEntity.class);
 	}
 
+	/**
+	 * Generic Execute. Use this method to execute custom FOXX services.
+	 * 
+	 * @param request
+	 *            VelocyStream request
+	 * @return VelocyStream response
+	 * @throws ArangoDBException
+	 */
 	public CompletableFuture<Response> execute(final Request request) {
 		return executor.execute(request, response -> response);
 	}

src/main/java/com/arangodb/ArangoDatabaseAsync.java

@@ -84,6 +84,13 @@ protected ArangoExecutorAsync executor() {
 		return executor;
 	}
 
+	/**
+	 * Returns a handler of the collection by the given name
+	 * 
+	 * @param name
+	 *            Name of the collection
+	 * @return collection handler
+	 */
 	public ArangoCollectionAsync collection(final String name) {
 		return new ArangoCollectionAsync(this, name);
 	}
@@ -459,6 +466,13 @@ public CompletableFuture<Collection<AqlFunctionEntity>> getAqlFunctions(final Aq
 		}.getType());
 	}
 
+	/**
+	 * Returns a handler of the graph by the given name
+	 * 
+	 * @param name
+	 *            Name of the graph
+	 * @return graph handler
+	 */
 	public ArangoGraphAsync graph(final String name) {
 		return new ArangoGraphAsync(this, name);
 	}

src/main/java/com/arangodb/ArangoGraphAsync.java

@@ -90,10 +90,24 @@ public CompletableFuture<GraphEntity> addVertexCollection(final String name) {
 		return executor.execute(addVertexCollectionRequest(name), addVertexCollectionResponseDeserializer());
 	}
 
+	/**
+	 * Returns a handler of the vertex collection by the given name
+	 * 
+	 * @param name
+	 *            Name of the vertex collection
+	 * @return collection handler
+	 */
 	public ArangoVertexCollectionAsync vertexCollection(final String name) {
 		return new ArangoVertexCollectionAsync(this, name);
 	}
 
+	/**
+	 * Returns a handler of the edge collection by the given name
+	 * 
+	 * @param name
+	 *            Name of the edge collection
+	 * @return collection handler
+	 */
 	public ArangoEdgeCollectionAsync edgeCollection(final String name) {
 		return new ArangoEdgeCollectionAsync(this, name);
 	}