diff --git a/services/src/main/java/io/scalecube/services/Microservices.java b/services/src/main/java/io/scalecube/services/Microservices.java
index 1796843c..fb02ecae 100644
--- a/services/src/main/java/io/scalecube/services/Microservices.java
+++ b/services/src/main/java/io/scalecube/services/Microservices.java
@@ -386,6 +386,11 @@ public ServiceDiscovery discovery() {
     return this.discovery;
   }
 
+  /**
+   * Shutdown instance and clear resources.
+   *
+   * @return result of shutdown
+   */
   public Mono<Void> shutdown() {
     return Mono.defer(
         () ->