diff --git a/xplat/Sonar/SonarStep.h b/xplat/Sonar/SonarStep.h
index afb18923a..854c93d78 100644
--- a/xplat/Sonar/SonarStep.h
+++ b/xplat/Sonar/SonarStep.h
@@ -14,8 +14,14 @@ class SonarState;
 
 class SonarStep {
  public:
+  /* Mark this step as completed successfully
+   * failing to call complete() will be registered as a failure
+   * when the destructor is executed. */
   void complete();
+
+  // Mark the step as failed, and provide a message.
   void fail(std::string message);
+
   SonarStep(std::string name, SonarState* state);
   ~SonarStep();