diff --git a/lib/browser/components/progress-button/directives/progress-button.js b/lib/browser/components/progress-button/directives/progress-button.js
index 9562902e..1398ab41 100644
--- a/lib/browser/components/progress-button/directives/progress-button.js
+++ b/lib/browser/components/progress-button/directives/progress-button.js
@@ -17,14 +17,19 @@
 'use strict';
 
 /**
+ * @summary ProgressButton directive
+ * @function
+ * @public
+ *
+ * @description
  * This directive provides a button containing a progress bar inside.
  * The button is styled by default as a primary button.
  *
- * Example:
+ * @returns {Object} directive
  *
+ * @example
  * <progress-button percentage="{{ 40 }}" striped>My Progress Button</progress-button>
  */
-
 module.exports = function() {
   return {
     templateUrl: './browser/components/progress-button/templates/progress-button.tpl.html',
diff --git a/lib/browser/os/open-external/directives/open-external.js b/lib/browser/os/open-external/directives/open-external.js
index c79a993e..2cf841f3 100644
--- a/lib/browser/os/open-external/directives/open-external.js
+++ b/lib/browser/os/open-external/directives/open-external.js
@@ -22,14 +22,19 @@ const os = require('os');
 const nodeOpen = require('open');
 
 /**
+ * @summary OsOpenExternal directive
+ * @function
+ * @public
+ *
+ * @description
  * This directive provides an attribute to open an external
  * resource with the default operating system action.
  *
- * Example:
+ * @returns {Object} directive
  *
+ * @example
  * <button os-open-external="https://resin.io">Resin.io</button>
  */
-
 module.exports = function() {
   return {
     restrict: 'A',