diff --git a/code/nel/tools/pipeline/max/class_directory_3.h b/code/nel/tools/pipeline/max/class_directory_3.h
index f6e3e9b15..1b96198d6 100644
--- a/code/nel/tools/pipeline/max/class_directory_3.h
+++ b/code/nel/tools/pipeline/max/class_directory_3.h
@@ -51,7 +51,11 @@ class CClassEntry;
  * \brief CClassDirectory3
  * \date 2012-08-18 18:01GMT
  * \author Jan Boon (Kaetemi)
- * CClassDirectory3
+ * This class is used for parsing the local class indices in a max file,
+ * both reading and writing is supported. It is not used at runtime,
+ * and should be reset when no longer necessary. Plugins have their own
+ * static copy of the actual ISceneClassDesc. This class only contains
+ * CClassEntry instances, which should not be used directly.
  */
 class CClassDirectory3 : public CStorageContainer
 {
diff --git a/code/nel/tools/pipeline/max/dll_directory.h b/code/nel/tools/pipeline/max/dll_directory.h
index 728fbdce5..f4020de39 100644
--- a/code/nel/tools/pipeline/max/dll_directory.h
+++ b/code/nel/tools/pipeline/max/dll_directory.h
@@ -47,7 +47,14 @@ class CDllEntry;
  * \brief CDllDirectory
  * \date 2012-08-18 09:01GMT
  * \author Jan Boon (Kaetemi)
- * CDllDirectory
+ * This class is used for parsing the local dll indices in a max file,
+ * both reading and writing is supported. It is not used at runtime,
+ * and should be reset when no longer necessary. Plugins have their own
+ * copy of the actual IDllPluginDescInternal. This class only contains
+ * CDllEntry instances, which should not be used directly. The instance
+ * of this class used to parse the max file should be kept, as there
+ * might be chunks that were not parsed, which should be rewritten to
+ * the stream.
  */
 class CDllDirectory : public CStorageContainer
 {