diff --git a/metafacture-xml/src/main/java/org/metafacture/xml/GenericXmlHandler.java b/metafacture-xml/src/main/java/org/metafacture/xml/GenericXmlHandler.java
index 3fbe15da6..6bfd72591 100644
--- a/metafacture-xml/src/main/java/org/metafacture/xml/GenericXmlHandler.java
+++ b/metafacture-xml/src/main/java/org/metafacture/xml/GenericXmlHandler.java
@@ -34,7 +34,11 @@
  * @author Markus Michael Geipel
  *
  */
-@Description("A generic xml reader")
+@Description("A generic XML reader. Separates XML data in distinct records with the defined record tag name (default: `recordtagname=\"record\"`) " +
+        "If no matching record tag is found, the output will be empty. " +
+        "The handler breaks down XML elements with simple string values and optional attributes " +
+        "into entities with a value subfield (name configurable) and additional subfields for each attribute. " +
+        "Record tag and value tag names can be configured. Attributes can get an attributeMarker.")
 @In(XmlReceiver.class)
 @Out(StreamReceiver.class)
 @FluxCommand("handle-generic-xml")
diff --git a/metafacture-xml/src/main/java/org/metafacture/xml/SimpleXmlEncoder.java b/metafacture-xml/src/main/java/org/metafacture/xml/SimpleXmlEncoder.java
index 485ed7c62..eb39d6671 100644
--- a/metafacture-xml/src/main/java/org/metafacture/xml/SimpleXmlEncoder.java
+++ b/metafacture-xml/src/main/java/org/metafacture/xml/SimpleXmlEncoder.java
@@ -47,7 +47,7 @@
  * @author Christoph Böhme
  *
  */
-@Description("Encodes a stream as xml")
+@Description("Encodes a stream as XML. Defaults: `rootTag=\"records\"`, `recordTag=\"record\"`, no attributeMarker.")
 @In(StreamReceiver.class)
 @Out(String.class)
 @FluxCommand("stream-to-xml")