diff --git a/lua/gruber-darker/color.lua b/lua/gruber-darker/color.lua
index cfef869..f30aa00 100644
--- a/lua/gruber-darker/color.lua
+++ b/lua/gruber-darker/color.lua
@@ -5,7 +5,7 @@ Color.__index = Color
 
 ---Create a new color
 ---@param value integer
----@return table
+---@return Color
 function Color.new(value)
 	local color = setmetatable({
 		value = value,
@@ -14,7 +14,7 @@ function Color.new(value)
 end
 
 ---Create the "NONE" color
----@return table
+---@return Color
 function Color.none()
 	local color = setmetatable({
 		value = nil,
diff --git a/lua/gruber-darker/highlights/init.lua b/lua/gruber-darker/highlights/init.lua
index 09f44f1..b8c4259 100644
--- a/lua/gruber-darker/highlights/init.lua
+++ b/lua/gruber-darker/highlights/init.lua
@@ -2,7 +2,7 @@ local M = {}
 
 ---@class HighlightsProvider
 ---@field highlights table<string, Highlight>
----@field setup fun()
+---@field setup fun() Set highlights
 
 ---@type HighlightsProvider[]
 local providers = {
diff --git a/lua/gruber-darker/highlights/lsp.lua b/lua/gruber-darker/highlights/lsp.lua
index 8eaf7ae..ae4a32f 100644
--- a/lua/gruber-darker/highlights/lsp.lua
+++ b/lua/gruber-darker/highlights/lsp.lua
@@ -1,6 +1,5 @@
 local Highlight = require("gruber-darker.highlight")
-local c = require("gruber-darker.palette")
-local opts = require("gruber-darker.config").get_opts()
+local vim_hl = require("gruber-darker.highlights.vim").highlights
 local gruber_hl = require("gruber-darker.highlights.colorscheme").highlights
 
 ---@type HighlightsProvider
@@ -44,4 +43,20 @@ M.highlights.diagnostic_underline_hint =
 ---Used to highlight the active parameter in the signature help.
 -- M.highlights.lsp_signature_active_parameter = Highlight.new("LspSignatureActiveParameter", {})
 
+-- M.highlights.lsp_type_class = Highlight.new("@lsp.type.class", {})
+-- M.highlights.lsp_type_decorator = Highlight.new("@lsp.type.decorator", {})
+-- M.highlights.lsp_type_enum = Highlight.new("@lsp.type.enum", {})
+-- M.highlights.lsp_type_enum_member = Highlight.new("@lsp.type.enumMember", {})
+-- M.highlights.lsp_type_function = Highlight.new("@lsp.type.function", {})
+-- M.highlights.lsp_type_interface = Highlight.new("@lsp.type.interface", {})
+-- M.highlights.lsp_type_macro = Highlight.new("@lsp.type.macro", {})
+-- M.highlights.lsp_type_method = Highlight.new("@lsp.type.method", {})
+-- M.highlights.lsp_type_namespace = Highlight.new("@lsp.type.namespace", {})
+-- M.highlights.lsp_type_parameter = Highlight.new("@lsp.type.parameter", {})
+-- M.highlights.lsp_type_property = Highlight.new("@lsp.type.property", {})
+-- M.highlights.lsp_type_struct = Highlight.new("@lsp.type.struct", {})
+-- M.highlights.lsp_type_type = Highlight.new("@lsp.type.type", {})
+-- M.highlights.lsp_type_type_parameter = Highlight.new("@lsp.type.typeParameter", {})
+-- M.highlights.lsp_type_variable = Highlight.new("@lsp.type.variable", {})
+
 return M
diff --git a/lua/gruber-darker/highlights/treesitter.lua b/lua/gruber-darker/highlights/treesitter.lua
index 56735eb..c4a72f3 100644
--- a/lua/gruber-darker/highlights/treesitter.lua
+++ b/lua/gruber-darker/highlights/treesitter.lua
@@ -25,6 +25,7 @@ end
 M.highlights.comment = Highlight.new("@comment", { link = vim_hl.comment })
 ---Comments documenting code
 M.highlights.comment_documentation = Highlight.new("@comment.documentation", { link = gruber_hl.green })
+M.highlights.comment_luadoc = Highlight.new("@comment.luadoc", { link = M.highlights.comment_documentation })
 ---Syntax/parser errors
 M.highlights.error = Highlight.new("@error", {})
 ---Completely disable the highlight
diff --git a/lua/gruber-darker/highlights/vim.lua b/lua/gruber-darker/highlights/vim.lua
index 51ba9c1..15101fc 100644
--- a/lua/gruber-darker/highlights/vim.lua
+++ b/lua/gruber-darker/highlights/vim.lua
@@ -210,7 +210,8 @@ M.highlights.structure = Highlight.new("Structure", { link = gruber_hl.yellow_bo
 M.highlights.typedef = Highlight.new("Typedef", { link = gruber_hl.yellow_bold })
 ---(preferred) any special symbol
 M.highlights.special = Highlight.new("Special", { link = gruber_hl.yellow })
-M.highlights.special_char = Highlight.new("SpecialChar", { link = gruber_hl.yellow }) --- special character in a constant
+--- special character in a constant
+M.highlights.special_char = Highlight.new("SpecialChar", { link = gruber_hl.yellow })
 ---You can use CTRL-] on this
 M.highlights.tag = Highlight.new("Tag", { link = gruber_hl.yellow })
 ---Character that needs attention