Add comments

src/Yarhl/FileSystem/Node.cs

@@ -54,7 +54,11 @@ public Node(string name, IFormat initialFormat)
         /// </summary>
         /// <param name="node">The original node.</param>
         /// <remarks><para>It makes a copy of the original node.
-        /// The original format is deep copied. See <see cref="ICloneableFormat"/> for details.</para></remarks>
+        /// The original format is deep copied. See <see cref="ICloneableFormat"/> for details.</para>
+        /// </remarks>
+        /// <remarks><para>If the node has children, it must be a <see cref="NodeContainerFormat"/> to clone them.
+        /// In other case, the format must implement <see cref="ICloneableFormat"/> and clone the children explicitly.
+        /// </para></remarks>
         public Node(Node node)
             : this(node != null ? node.Name : string.Empty)
         {

src/Yarhl/IO/BinaryFormat.cs

@@ -94,7 +94,12 @@ public BinaryFormat(Stream stream, long offset, long length)
             private set;
         }
 
-        /// <inheritdoc />
+        /// <summary>
+        /// Makes a copy of the format stream <strong>into memory</strong>
+        /// and returns a new <see cref="BinaryFormat"/> object.
+        /// </summary>
+        /// <remarks><para>The stream is copied into memory, so it is limited to 2GB size.</para></remarks>
+        /// <returns>The cloned <see cref="BinaryFormat"/>.</returns>
         public virtual object DeepClone()
         {
             DataStream newStream = DataStreamFactory.FromMemory();