diff --git a/lib/oga/xml/lexer.rb b/lib/oga/xml/lexer.rb
index 41a8120..485fa17 100644
--- a/lib/oga/xml/lexer.rb
+++ b/lib/oga/xml/lexer.rb
@@ -342,7 +342,7 @@ module Oga
       ##
       # Called on regular text values.
       #
-      # @param [String] text
+      # @param [String] value
       #
       def on_text(value)
         unless value.empty?
diff --git a/lib/oga/xml/parser.y b/lib/oga/xml/parser.y
index 4019a7c..52c1f2f 100644
--- a/lib/oga/xml/parser.y
+++ b/lib/oga/xml/parser.y
@@ -330,7 +330,6 @@ Unexpected #{name} with value #{value.inspect} on line #{@line}:
   # @param [String] namespace
   # @param [String] name
   # @param [Hash] attributes
-  # @param [Array] children
   # @return [Oga::XML::Element]
   #
   def on_element(namespace, name, attributes = {})
@@ -355,7 +354,7 @@ Unexpected #{name} with value #{value.inspect} on line #{@line}:
   end
 
   ##
-  # @param [Oga::XML::Element]
+  # @param [Oga::XML::Element] element
   # @return [Oga::XML::Element]
   #
   def after_element(element)
diff --git a/lib/oga/xpath/parser.y b/lib/oga/xpath/parser.y
index 5b1c496..5e9799d 100644
--- a/lib/oga/xpath/parser.y
+++ b/lib/oga/xpath/parser.y
@@ -133,8 +133,6 @@ end
   ##
   # @param [String] data The input to parse.
   #
-  # @param [Hash] options
-  #
   def initialize(data)
     @data  = data
     @lexer = Lexer.new(data)