diff --git a/app/models/ticket/escalation.rb b/app/models/ticket/escalation.rb
index e5cc7ef8f..085071369 100644
--- a/app/models/ticket/escalation.rb
+++ b/app/models/ticket/escalation.rb
@@ -2,6 +2,18 @@
 
 module Ticket::Escalation
 
+=begin
+
+rebuild escalations for all open tickets
+
+  result = Ticket::Escalation.rebuild_all
+
+returns
+
+  result = true
+
+=end
+
   def self.rebuild_all
     ticket_state_list_open = Ticket::State.by_category( 'open' )
 
@@ -11,6 +23,19 @@ module Ticket::Escalation
     }
   end
 
+=begin
+
+rebuild escalation for ticket
+
+  ticket = Ticket.find(123)
+  result = ticket.escalation_calculation
+
+returns
+
+  result = true
+
+=end
+
   def escalation_calculation
 
     # set escalation off if ticket is already closed