Index: dam engine/trunk/src/Deltares.DamEngine.Calculators/KernelWrappers/Interfaces/IKernelWrapper.cs
===================================================================
diff -u -r564 -r672
--- dam engine/trunk/src/Deltares.DamEngine.Calculators/KernelWrappers/Interfaces/IKernelWrapper.cs	(.../IKernelWrapper.cs)	(revision 564)
+++ dam engine/trunk/src/Deltares.DamEngine.Calculators/KernelWrappers/Interfaces/IKernelWrapper.cs	(.../IKernelWrapper.cs)	(revision 672)
@@ -5,11 +5,50 @@
 
 namespace Deltares.DamEngine.Calculators.KernelWrappers.Interfaces
 {
+    /// <summary>
+    /// Result of the Prepare method
+    ///   Successful : the input data was created susccesfully
+    ///   Failed     : the input data could not be created
+    ///   NotRelevant: the DamKernelInput contains data that is not a relevant input for this mechanism 
+    /// </summary>
+    public enum PrepareResult
+    {
+        Successful,  
+        Failed,
+        NotRelevant
+    };
+    /// <summary>
+    /// Interface to implement external failure mechanisms
+    /// </summary>
     interface IKernelWrapper
     {
-        IKernelDataInput Prepare(DamKernelInput damKernelInput);
+        /// <summary>
+        /// Prepares the failure mechanism input based on general dam kernel input.
+        /// </summary>
+        /// <param name="damKernelInput">The dam kernel input.</param>
+        /// <param name="kernelDataInput">The kernel data input.</param>
+        /// <returns></returns>
+        PrepareResult Prepare(DamKernelInput damKernelInput, out IKernelDataInput kernelDataInput);
+        /// <summary>
+        /// Validates the kernel data input.
+        /// </summary>
+        /// <param name="kernelDataInput">The kernel data input.</param>
+        /// <param name="messages">The messages.</param>
+        /// <returns></returns>
         int Validate(IKernelDataInput kernelDataInput, out List<LogMessage> messages);
+        /// <summary>
+        /// Performs a failure mechanism calcualtion based on the input.
+        /// </summary>
+        /// <param name="kernelDataInput">The kernel data input.</param>
+        /// <param name="messages">The messages.</param>
+        /// <returns></returns>
         IKernelDataOutput Execute(IKernelDataInput kernelDataInput, out List<LogMessage> messages);
+        /// <summary>
+        /// Fills the dam result based on the kernel output.
+        /// </summary>
+        /// <param name="damKernelInput">The dam kernel input.</param>
+        /// <param name="kernelDataOutput">The kernel data output.</param>
+        /// <param name="designResult">The design result.</param>
         void PostProcess(DamKernelInput damKernelInput, IKernelDataOutput kernelDataOutput, out DesignResult designResult);
     }
 }