Merge pull request #377 from katarinaking/817

MNEMONIC-817: Refined Durable Computable Interface

mnemonic-sessions/src/main/java/org/apache/mnemonic/sessions/DurableComputable.java

@@ -20,9 +20,25 @@
 
 import org.apache.mnemonic.RestorableAllocator;
 
+/**
+ * Represents a durable computable entity.
+ *
+ * @param <A> the type of the allocator
+ */
 public interface DurableComputable<A extends RestorableAllocator<A>> {
 
-  A getAllocator();
+    /**
+     * Retrieves the allocator associated with this computable entity.
+     *
+     * @return the allocator
+     */
+    A getAllocator();
 
-  long getHandler();
+    /**
+     * Retrieves the handler associated with this computable entity.
+     *
+     * @return the handler
+     */
+    long getHandler();
 }
+