diff --git a/lib/naughty/action.lua b/lib/naughty/action.lua
index 6d871da1e..abc24c4da 100644
--- a/lib/naughty/action.lua
+++ b/lib/naughty/action.lua
@@ -6,7 +6,7 @@
 --
 -- @author Emmanuel Lepage Vallee <elv1313@gmail.com>
 -- @copyright 2019 Emmanuel Lepage Vallee
--- @classmod naughty.action
+-- @coreclassmod naughty.action
 ---------------------------------------------------------------------------
 local gtable  = require("gears.table" )
 local gobject = require("gears.object")
@@ -101,6 +101,10 @@ for _, prop in ipairs { "name", "icon", "notification", "icon_only" } do
 end
 
 --- Execute this action.
+--
+-- This only emits the `invoked` signal.
+--
+-- @method invoke
 function action:invoke()
     assert(self._private.notification,
         "Cannot invoke an action without a notification")
diff --git a/lib/naughty/notification.lua b/lib/naughty/notification.lua
index dbdb94294..5004cfc71 100644
--- a/lib/naughty/notification.lua
+++ b/lib/naughty/notification.lua
@@ -199,11 +199,11 @@ local notification = {}
 --@DOC_naughty_shape_EXAMPLE@
 --
 -- @property shape
--- @param gears.shape
+-- @tparam gears.shape shape
 
 --- Widget opacity.
 -- @property opacity
--- @param number From 0 to 1
+-- @tparam number opacity Between 0 to 1.
 
 --- Widget margin.
 --