diff --git a/gxml/SerializableGeeArrayList.vala b/gxml/SerializableGeeArrayList.vala
index 68ab79faa6982c86c8ef74bf36baf04c26fb6531..eb8d61cebe35da13921f20bef809972f6d229880 100644
--- a/gxml/SerializableGeeArrayList.vala
+++ b/gxml/SerializableGeeArrayList.vala
@@ -23,7 +23,7 @@ using GXml;
 using Gee;
 
 /**
- * A {@link Serializable} objects container.
+ * Serializable Framework. A {@link Serializable} objects container based on {@link Gee.ArrayList}.
  * 
  * It is derived  It implements {@link Serializable} and {@link SerializableCollection}
  * interfaces.
diff --git a/gxml/SerializableGeeDualKeyMap.vala b/gxml/SerializableGeeDualKeyMap.vala
index e210ae66ef20b091888c2278816ac0eba792578a..b6bd29cae2af1195263b3b7144b6fc1e8b3672c8 100644
--- a/gxml/SerializableGeeDualKeyMap.vala
+++ b/gxml/SerializableGeeDualKeyMap.vala
@@ -23,9 +23,10 @@ using GXml;
 using Gee;
 
 /**
- * A {@link Serializable} objects container. It uses two keys and value store.
+ * Serializable Framework. A {@link Serializable} objects container based on Gee interfaces with dual key.
  * 
- * It implements {@link Serializable} and {@link SerializableCollection} interfaces.
+ * It implements {@link Serializable} and {@link SerializableCollection} interfaces, it is iterable as
+ * other Gee collections.
  */
 public class GXml.SerializableDualKeyMap<P,S,V> : Object, Serializable, SerializableCollection
 {
diff --git a/gxml/SerializableGeeTreeMap.vala b/gxml/SerializableGeeTreeMap.vala
index c4bc0a23db036cc0e2c00716777fd2df5cbea998..ef91fd022ea186d4c78376ac5a149bf1756c53a4 100644
--- a/gxml/SerializableGeeTreeMap.vala
+++ b/gxml/SerializableGeeTreeMap.vala
@@ -21,7 +21,7 @@
  */
 using GXml;
 /**
- * A {@link Serializable} objects container.
+ * Serializable Framework. A {@link Serializable} objects container based on {@link Gee.TreeMap}.
  * 
  * It uses a key and value store implementing {@link Gee.TreeMap} interface.
  * It implements {@link Serializable} and {@link SerializableCollection} interfaces.
diff --git a/gxml/libxml-NamedAttrMap.vala b/gxml/libxml-NamedAttrMap.vala
index 2d92ebd3b5cb9e719e0d422988d8b038f18de181..a7e6b23f1d25ddba055b2eb7c9d9daf218295856 100644
--- a/gxml/libxml-NamedAttrMap.vala
+++ b/gxml/libxml-NamedAttrMap.vala
@@ -26,9 +26,10 @@ using Gee;
 
 namespace GXml {
 	/**
-	 * A class implementing {@link GXml.NamedNodeMap} interface for {@link GXml.xAttr} objects.
+	 * An abstract class used as base class for {@link GXml.NamedAttrMap} class.
 	 * 
-	 * A collection of {@link GXml.NamedNodeMap} of type {@link GXml.Attr} objects in a {@link GXml.xElement}.
+	 * This is just an auxiliary class to implement {@link Gee.Traversable}
+	 * {@link Gee.Iterable} interfaces.
 	 */
 	public abstract class AbstractNamedAttrMap : Object,
 		Traversable<Entry<string,GXml.Attribute>>,
@@ -119,6 +120,9 @@ namespace GXml {
 	 * A class implementing {@link GXml.NamedNodeMap} interface for {@link GXml.xAttr} objects.
 	 * 
 	 * A collection of {@link GXml.NamedNodeMap} of type {@link GXml.xAttr} objects in a {@link GXml.xElement}.
+	 *
+	 * This class implements {@link Gee.Map}, but requires parent {@link GXml.AbstractNamedAttrMap} class
+	 * in order to implement it.
 	 */
 	public class NamedAttrMap : AbstractNamedAttrMap, Map<string,GXml.Attribute>,
 		NamedNodeMap<xAttr?>
diff --git a/gxml/libxml-NamespaceAttr.vala b/gxml/libxml-NamespaceAttr.vala
index 3160797e3e39778edf73ab67910dab51c34fbd9c..a24c0f4a441799d6e2bb25993e24c7d531b5a16e 100644
--- a/gxml/libxml-NamespaceAttr.vala
+++ b/gxml/libxml-NamespaceAttr.vala
@@ -24,11 +24,11 @@
 
 namespace GXml {
 	/**
-	 * Represents an XML Namespace Attr node.
+	 * Represents an XML Namespace for a {@link GXml.Node} node.
 	 *
 	 * These represent
-	 * prefix=uri pairs that define namespaces for XML Elements
-	 * and Attrs.
+	 * prefix=uri pairs that define namespaces for XML {@link GXml.xElements}
+	 * and {@link GXml.xAttr}.
 	 */
 	public class NamespaceAttr : xNode, GXml.Namespace {
 		/** Private properties */