diff --git a/src/main/java/forge/deck/Deck.java b/src/main/java/forge/deck/Deck.java
index 72203155b16..ba26611e19b 100644
--- a/src/main/java/forge/deck/Deck.java
+++ b/src/main/java/forge/deck/Deck.java
@@ -12,6 +12,10 @@ import java.util.*;
 
 /**
  * <p>Deck class.</p>
+ * 
+ * The set of MTG legal cards that become player's library when the game starts. 
+ * Any other data is not part of a deck and should be stored elsewhere.
+ * Current fields allowed for deck metadata are Name, Title, Description, Difficulty, Icon, Comment.
  *
  * @author Forge
  * @version $Id$