diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/IUnitOfWork.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/IUnitOfWork.java
index bd1fcbffa..e0b453498 100644
--- a/unit-of-work/src/main/java/com/iluwatar/unitofwork/IUnitOfWork.java
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/IUnitOfWork.java
@@ -32,12 +32,24 @@ public interface IUnitOfWork<T> {
   String DELETE = "DELETE";
   String MODIFY = "MODIFY";
 
+  /**
+   * Any register new operation occurring on UnitOfWork is only going to be performed on commit.
+   */
   void registerNew(T entity);
 
+  /**
+   * Any register modify operation occurring on UnitOfWork is only going to be performed on commit.
+   */
   void registerModified(T entity);
 
+  /**
+   * Any register delete operation occurring on UnitOfWork is only going to be performed on commit.
+   */
   void registerDeleted(T entity);
 
+  /***
+   * All UnitOfWork operations batched together executed in commit only.
+   */
   void commit();
 
 }
\ No newline at end of file
diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java
index 7bcccc61b..ff1136620 100644
--- a/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java
@@ -78,6 +78,9 @@ public class StudentRepository implements IUnitOfWork<Student> {
     context.put(operation, studentsToOperate);
   }
 
+  /**
+   * All UnitOfWork operations are batched and executed together on commit only.
+   */
   @Override
   public void commit() {
     if (context == null || context.size() == 0) {