yard-lint 1.9.0 → 1.10.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba0156cdfc89e9d83eb44c650fc7577e68256717646470736a1a5051d45c8830
-  data.tar.gz: f12452f074b35d19f8edaf2fe4d4e28dcda832e0b355b500980e21e97b96c71b
+  metadata.gz: 0c63ea819ad85e3c0878e26d37ea3b59bb61598804d3963425ff5882931b1a22
+  data.tar.gz: 5b613e3ba58f6773abd4b47b23c64e94d223ddecde10a743db5de1525b0f5ec2
 SHA512:
-  metadata.gz: 1d453260f7016fcdb0f678d22349ffd922eb941f7daec2393bde3c81798bee88669cd003134f72c8a85fc44c700953e72c10d3ca930df96b33d15efbff1cbaf9
-  data.tar.gz: 5b0f7a4c24095a2db9d5c584029a23e2ff49dfcdd01c534ce5ac9922d2d8c5206f0137046815d5b9bfbffb3be4dff908df9409a99842db9234dd81c1471dceb6
+  metadata.gz: 608923c037bde8d53573ae6f7d3487d1b156ba04ae94c143675c5c5f6c541ccb6266df7acf1748e7fd54e9e3bb92942a28fd2d62d560b92b6ee6e5373f60c822
+  data.tar.gz: 91863e353c9be138fa4bd93db36ce4cdf85209a85863dca25f6d7c1f3a794673018946d7e8160fedf801a4c80cf7377359f675462d87c7955aaf4b80fcffa68f

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 1.10.1 (2026-07-24)
+- **[Bugfix]** `Documentation/BlankLineBeforeDefinition` no longer reports a foreign comment block above a definition as documentation that was accidentally detached from it. When the object is documented (non-empty docstring) but that docstring did not come from the comment block sitting above this definition, the block is not a detached docstring - it is a file-level license/copyright banner, an encoding note, or an unrelated comment above a namespace reopening whose documentation lives in another file. The check compares the object's docstring against the block's text, so it recognizes any such banner without hardcoding its wording. Definitions whose documentation was genuinely lost (an undocumented object with a comment block detached above it) are still reported.
+
+## 1.10.0 (2026-07-24)
+- **[Feature]** Added `Documentation/DuplicateNamespaceComment` (enabled by default, severity `warning`) - detects namespaces (modules and classes) that carry a YARD documentation comment in more than one file. When a namespace is reopened across files and documented in several of them, YARD merges the reopenings into a single object and keeps only one docstring, silently discarding the rest (the last documented reopening wins, with no warning), so competing descriptions are lost. This is a common accident for shared namespaces (e.g. `Users` or `Users::Operations`) spread across many files; it does not affect a leaf object such as `Users::Operations::Create` that lives in a single file. Because YARD does not record which reopening carried a comment, the validator re-reads each definition site to detect the documented ones (ignoring blank-line-detached comments and directive/magic comments), and reports one offense per namespace documented in two or more files, listing every documented location and noting when the docstrings differ (meaning content is actually lost). Configurable via the standard `Enabled` and `Severity` keys.
+
 ## 1.9.0 (2026-07-01)
 - **[Breaking]** Dropped support for Ruby 3.2. The minimum required Ruby version is now 3.3.0. This change was necessary because the `parallel` gem no longer supports Ruby 3.2.
 

data/README.md

@@ -31,7 +31,7 @@ YARD-Lint validates your YARD documentation for:
 - **Performance** - In-process YARD execution with shared registry (~10x faster than shell-based execution)
 - **Incremental Adoption** - `--auto-gen-config` generates a baseline todo file to adopt on legacy codebases without fixing everything first
 
-**See the complete list:** [All Features](https://github.com/mensfeld/yard-lint/wiki/Features) | [36 Validators](https://github.com/mensfeld/yard-lint/wiki/Validators)
+**See the complete list:** [All Features](https://github.com/mensfeld/yard-lint/wiki/Features) | [37 Validators](https://github.com/mensfeld/yard-lint/wiki/Validators)
 
 ## Installation
 
@@ -569,7 +569,7 @@ The text formatter also shows the validator path (e.g., `[Documentation/Orphaned
 - **[Wiki Home](https://github.com/mensfeld/yard-lint/wiki)** - Full documentation
 - **[Installation](https://github.com/mensfeld/yard-lint/wiki/Installation)** - Installation guide
 - **[Configuration](https://github.com/mensfeld/yard-lint/wiki/Configuration)** - Complete configuration reference
-- **[Validators](https://github.com/mensfeld/yard-lint/wiki/Validators)** - All 35 validators documented
+- **[Validators](https://github.com/mensfeld/yard-lint/wiki/Validators)** - All 37 validators documented
 - **[Features](https://github.com/mensfeld/yard-lint/wiki/Features)** - All features explained
 
 ### Workflows

data/lib/yard/lint/config.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-# YARD Lint - comprehensive linter for YARD documentation
 module Yard
   module Lint
     # Configuration object for YARD Lint

data/lib/yard/lint/config_validator.rb

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
-# YARD Lint - comprehensive linter for YARD documentation
 module Yard
-  # YARD Lint module providing linting functionality for YARD documentation
   module Lint
     # Validates configuration structure and values to catch typos and invalid settings
     class ConfigValidator

data/lib/yard/lint/templates/default_config.yml

@@ -137,6 +137,11 @@ Documentation/TextSubstitution:
     "—": "-"    # em-dash (U+2014)
     "–": "-"    # en-dash (U+2013)
 
+Documentation/DuplicateNamespaceComment:
+  Description: 'Detects namespaces (modules and classes) documented in more than one file.'
+  Enabled: true
+  Severity: warning
+
 # Tags validators
 Tags/Order:
   Description: 'Enforces consistent ordering of YARD tags.'

data/lib/yard/lint/templates/strict_config.yml

@@ -135,6 +135,11 @@ Documentation/TextSubstitution:
     "—": "-"    # em-dash (U+2014)
     "–": "-"    # en-dash (U+2013)
 
+Documentation/DuplicateNamespaceComment:
+  Description: 'Detects namespaces (modules and classes) documented in more than one file.'
+  Enabled: true
+  Severity: error
+
 # Tags validators
 Tags/Order:
   Description: 'Enforces consistent ordering of YARD tags.'

data/lib/yard/lint/validators/documentation/blank_line_before_definition/validator.rb

@@ -21,9 +21,19 @@ module Yard
               source_lines = File.readlines(object.file)
               definition_line = object.line - 1
 
-              blank_count, has_doc_block = analyze_spacing(source_lines, definition_line)
+              blank_count, doc_block_line = analyze_spacing(source_lines, definition_line)
 
-              return if blank_count.zero? || !has_doc_block
+              return if blank_count.zero? || doc_block_line.nil?
+
+              # Only a comment block that is genuinely THIS object's documentation can have
+              # been detached from it by the blank line. When the object is documented (its
+              # docstring is non-empty) but that docstring did not come from the comment block
+              # sitting above this definition, the block is a foreign comment - a file-level
+              # license/copyright banner, an encoding note, or an unrelated comment above a
+              # namespace reopening that is documented in another file - and the blank line is
+              # intentional. This is decided by comparing the object's docstring against the
+              # block's text, so it covers any such banner without hardcoding its wording.
+              return if foreign_comment_block?(object, source_lines, doc_block_line)
 
               violation_type = blank_count >= 2 ? 'orphaned' : 'single'
 
@@ -38,10 +48,10 @@ module Yard
             # Analyze spacing between documentation and definition
             # @param source_lines [Array<String>] lines of source file
             # @param definition_line [Integer] 0-indexed line of definition
-            # @return [Array<Integer, Boolean>] blank count and whether doc block exists
+            # @return [Array<Integer, Integer, nil>] blank count and the 0-indexed line of the
+            #   nearest documentation comment above the definition (nil when there is none)
             def analyze_spacing(source_lines, definition_line)
               blank_count = 0
-              has_doc_block = false
 
               (definition_line - 1).downto(0) do |i|
                 line = source_lines[i].to_s.rstrip
@@ -56,15 +66,65 @@ module Yard
                   # spurious blank-line offenses for undocumented definitions.
                   next if non_documentation_comment?(stripped)
 
-                  has_doc_block = true
-                  break
+                  return [blank_count, i]
                 else
                   # Non-comment, non-blank line - no documentation above
                   break
                 end
               end
 
-              [blank_count, has_doc_block]
+              [blank_count, nil]
+            end
+
+            # Whether the comment block above the definition is NOT the source of the object's
+            # documentation - a file banner or an unrelated comment rather than a docstring
+            # this definition lost to the blank line.
+            #
+            # An object with no docstring at all has genuinely orphaned documentation, so the
+            # block above is still reported. When the object IS documented, the block only
+            # counts as detached documentation if the docstring's text actually came from it;
+            # a license header or a comment above a reopening documented elsewhere carries
+            # different text and is left alone.
+            # @param object [YARD::CodeObjects::Base] the code object being checked
+            # @param source_lines [Array<String>] lines of source file
+            # @param doc_line [Integer] 0-indexed line of the nearest comment above the definition
+            # @return [Boolean]
+            def foreign_comment_block?(object, source_lines, doc_line)
+              docstring = object.docstring.to_s.strip
+              return false if docstring.empty?
+
+              block = comment_block_text(source_lines, doc_line)
+              first_line = normalize(docstring.lines.first.to_s)
+              return false if first_line.empty?
+
+              !normalize(block).include?(first_line)
+            end
+
+            # Text of the contiguous comment block that contains `doc_line`, stripped of the
+            # comment markers and joined into a single string.
+            # @param source_lines [Array<String>] lines of source file
+            # @param doc_line [Integer] 0-indexed line within the comment block
+            # @return [String]
+            def comment_block_text(source_lines, doc_line)
+              first = doc_line
+              first -= 1 while first.positive? && comment_line?(source_lines[first - 1])
+              last = doc_line
+              last += 1 while last + 1 < source_lines.length && comment_line?(source_lines[last + 1])
+
+              source_lines[first..last].map { |line| line.sub(/\A\s*#+\s?/, '').strip }.join(' ')
+            end
+
+            # @param line [String, nil] a source line
+            # @return [Boolean] whether the line is a comment line
+            def comment_line?(line)
+              line.to_s.strip.start_with?('#')
+            end
+
+            # Collapse whitespace so wrapped docstrings and their source comments compare equal.
+            # @param text [String]
+            # @return [String]
+            def normalize(text)
+              text.strip.gsub(/\s+/, ' ')
             end
 
             # Check if a comment line is a Ruby magic comment

data/lib/yard/lint/validators/documentation/duplicate_namespace_comment/config.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Yard
+  module Lint
+    module Validators
+      module Documentation
+        module DuplicateNamespaceComment
+          # Configuration for DuplicateNamespaceComment validator
+          class Config < ::Yard::Lint::Validators::Config
+            self.id = :duplicate_namespace_comment
+            self.defaults = {
+              'Enabled' => true,
+              'Severity' => 'warning'
+            }.freeze
+          end
+        end
+      end
+    end
+  end
+end

data/lib/yard/lint/validators/documentation/duplicate_namespace_comment/messages_builder.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Yard
+  module Lint
+    module Validators
+      module Documentation
+        module DuplicateNamespaceComment
+          # Builds messages for duplicate namespace comment offenses
+          class MessagesBuilder
+            # Maximum number of documented locations listed inline in the message
+            MAX_LISTED_SITES = 5
+
+            class << self
+              # Build message for a namespace documented in multiple files
+              # @param offense [Hash] offense data with :namespace, :sites and :conflict keys
+              # @return [String] formatted message
+              def call(offense)
+                sites = Array(offense[:sites])
+                listed = sites.first(MAX_LISTED_SITES).map { |site| relativize(site) }
+                remainder = sites.size - listed.size
+                located = listed.join(', ')
+                located += " (+#{remainder} more)" if remainder.positive?
+
+                differ = offense[:conflict] == 'differ' ? ' The docstrings differ, so content is lost.' : ''
+
+                "Namespace `#{offense[:namespace]}` is documented in #{sites.size} files; " \
+                  "YARD keeps only one docstring and discards the rest.#{differ} " \
+                  "Documented at: #{located}. " \
+                  'Consolidate the documentation into a single location.'
+              end
+
+              private
+
+              # Shortens an absolute "path:line" site to a path relative to the working
+              # directory for readability, leaving already-relative paths untouched.
+              # @param site [String] a "path:line" location
+              # @return [String] a display-friendly location
+              def relativize(site)
+                path, _, line = site.rpartition(':')
+                return site if path.empty?
+
+                relative = path.start_with?("#{Dir.pwd}/") ? path.sub("#{Dir.pwd}/", '') : path
+                "#{relative}:#{line}"
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/yard/lint/validators/documentation/duplicate_namespace_comment/parser.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Yard
+  module Lint
+    module Validators
+      module Documentation
+        module DuplicateNamespaceComment
+          # Extracts duplicate namespace documentation offenses from raw collector output.
+          # Each line has the form "file:line: Namespace\tsite|site|...\tconflict" where
+          # conflict is either 'same' or 'differ'.
+          # @example Output format (skip-lint)
+          #   /a.rb:6: Foo::Bar\t/a.rb:6|/b.rb:6\tsame
+          class Parser < ::Yard::Lint::Parsers::Base
+            # Parses the "file:line: Namespace" head of an offense line. The namespace
+            # path uses '::' and never ': ', so the final ": " is an unambiguous separator.
+            LINE_REGEX = /\A(.+):(\d+): (.+)\z/
+
+            # @param output [String] raw collector output, one offense per line
+            # @return [Array<Hash>] offense hashes with location/line/namespace/sites/conflict
+            def call(output)
+              return [] if output.nil? || output.empty?
+
+              output.split("\n").filter_map do |line|
+                head, sites, conflict = line.split("\t")
+                next unless head
+
+                match = head.match(LINE_REGEX)
+                next unless match
+
+                {
+                  location: match[1],
+                  line: match[2].to_i,
+                  namespace: match[3],
+                  sites: (sites || '').split('|'),
+                  conflict: conflict
+                }
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/yard/lint/validators/documentation/duplicate_namespace_comment/result.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Yard
+  module Lint
+    module Validators
+      module Documentation
+        module DuplicateNamespaceComment
+          # Result object for duplicate namespace comment validation
+          # Transforms parsed offenses into offense objects
+          class Result < Results::Base
+            self.default_severity = 'warning'
+            self.offense_type = 'line'
+            self.offense_name = 'DuplicateNamespaceComment'
+
+            # Build human-readable message for a duplicate namespace comment offense
+            # @param offense [Hash] offense data with :namespace, :sites and :conflict keys
+            # @return [String] formatted message
+            def build_message(offense)
+              MessagesBuilder.call(offense)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/yard/lint/validators/documentation/duplicate_namespace_comment/validator.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+module Yard
+  module Lint
+    module Validators
+      module Documentation
+        module DuplicateNamespaceComment
+          # Flags namespaces (modules and classes) that carry a documentation comment in
+          # more than one file. YARD keeps only one docstring per object, so documenting
+          # the same reopened namespace in several files silently discards all but one of
+          # those comments. Because YARD does not record which reopening carried a comment,
+          # the source is re-read at each definition site to detect the documented ones.
+          class Validator < Base
+            # Enable in-process execution including private/protected objects
+            in_process visibility: :all
+
+            # Comment lines that are directives or magic comments rather than
+            # documentation. A definition preceded only by these is not "documented".
+            IGNORED_COMMENT = /
+              \A\#!                             # shebang
+              |\A\#\s*frozen_string_literal:    # frozen_string_literal magic comment
+              |\A\#\s*-\*-                       # editor modeline, e.g. -*- coding: utf-8 -*-
+              |\A\#\s*(en)?coding[:=]            # encoding magic comment
+              |\A\#\s*warn_indent:              # warn_indent magic comment
+              |\A\#\s*rubocop:                  # rubocop directive
+              |\A\#\s*:nodoc:                   # nodoc directive
+              |\A\#\s*yard-lint:                # yard-lint inline directive
+            /x
+
+            private_constant :IGNORED_COMMENT
+
+            # Execute query for a single object during in-process execution.
+            # Emits one line per namespace documented in two or more files.
+            # @param object [YARD::CodeObjects::Base] the code object to query
+            # @param collector [Executor::ResultCollector] collector for output
+            # @return [void]
+            def in_process_query(object, collector)
+              # Only namespaces (modules and classes) get reopened across files.
+              # NamespaceObject excludes methods, constants, and the like.
+              return unless object.is_a?(YARD::CodeObjects::NamespaceObject)
+              # A namespace defined in a single file can only be documented once.
+              return if object.files.size < 2
+
+              documented = object.files.select do |file, line|
+                line && documented_site?(file, line)
+              end
+
+              return if documented.size < 2
+
+              primary_file, primary_line = documented.first
+              sites = documented.map { |file, line| "#{file}:#{line}" }.join('|')
+              texts = documented.map { |file, line| doc_text(file, line) }
+              conflict = texts.uniq.size > 1 ? 'differ' : 'same'
+
+              collector.puts "#{primary_file}:#{primary_line}: #{object.title}\t#{sites}\t#{conflict}"
+            end
+
+            private
+
+            # Whether the definition at a location is preceded by a real doc comment,
+            # as opposed to no comment, a blank-separated (detached) comment, or only
+            # directive/magic comments.
+            # @param file [String] path to the source file
+            # @param line [Integer] 1-based line of the namespace definition
+            # @return [Boolean] true when the site carries documentation
+            def documented_site?(file, line)
+              !comment_lines(file, line).empty?
+            end
+
+            # Joins the documentation text at a location so identical and differing
+            # documentation across sites can be told apart.
+            # @param file [String] path to the source file
+            # @param line [Integer] 1-based line of the namespace definition
+            # @return [String] normalized comment text ('' when undocumented)
+            def doc_text(file, line)
+              comment_lines(file, line).join("\n")
+            end
+
+            # Collects the contiguous block of documentation comment lines directly
+            # above a definition, dropping directive/magic comments. A blank line
+            # between the comment and the definition detaches it (YARD behaviour), so
+            # scanning stops at the first blank or non-comment line.
+            # @param file [String] path to the source file
+            # @param line [Integer] 1-based line of the namespace definition
+            # @return [Array<String>] normalized documentation lines
+            def comment_lines(file, line)
+              lines = source_lines(file)
+              return [] if lines.empty?
+
+              collected = []
+              index = line - 2 # zero-based line directly above the definition
+
+              while index >= 0
+                text = lines[index].strip
+                break if text.empty? || !text.start_with?('#')
+
+                collected << text unless text.match?(IGNORED_COMMENT)
+                index -= 1
+              end
+
+              collected
+            end
+
+            # Reads source lines for a file, tolerating unreadable paths so a single
+            # bad location drops only its own site instead of hiding the whole object.
+            # @param file [String] path to the source file
+            # @return [Array<String>] file lines, or an empty array when unreadable
+            def source_lines(file)
+              cached_lines(file)
+            rescue SystemCallError, IOError
+              []
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/yard/lint/validators/documentation/duplicate_namespace_comment.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Yard
+  module Lint
+    module Validators
+      module Documentation
+        # DuplicateNamespaceComment validator
+        #
+        # Detects namespaces (modules and classes) that carry a YARD documentation
+        # comment in more than one file. When a namespace is reopened across several
+        # files, YARD merges every reopening into a single object and keeps only one
+        # docstring - the last documented reopening wins and all the other comments are
+        # silently discarded, with no warning. This is a common accident for shared
+        # namespaces (e.g. `Users` or `Users::Operations`) that are spread across many
+        # files. It is not a concern for a leaf object such as `Users::Operations::Create`
+        # which is normally defined in a single file and can only be documented once.
+        #
+        # The validator reports one offense per namespace that is documented in two or
+        # more files, listing every documented location so the duplicates can be
+        # consolidated into a single canonical spot.
+        #
+        # @example Bad - the same namespace documented in two files
+        #   # a.rb
+        #   # Handles user operations
+        #   module Users; end
+        #
+        #   # b.rb
+        #   # User-related helpers   # <- silently discarded by YARD
+        #   module Users; end
+        #
+        # @example Good - document the namespace in exactly one place
+        #   # a.rb
+        #   # Handles user operations
+        #   module Users; end
+        #
+        #   # b.rb
+        #   module Users; end        # <- reopened without a comment
+        #
+        # ## Configuration
+        #
+        # To disable this validator:
+        #
+        #     Documentation/DuplicateNamespaceComment:
+        #       Enabled: false
+        module DuplicateNamespaceComment
+        end
+      end
+    end
+  end
+end

data/lib/yard/lint/validators/tags/example_syntax.rb

@@ -3,7 +3,6 @@
 module Yard
   module Lint
     module Validators
-      # Tags validators - validate YARD tag quality and consistency
       module Tags
         # ExampleSyntax validator
         #

data/lib/yard/lint/validators/tags/redundant_param_description.rb

@@ -3,7 +3,6 @@
 module Yard
   module Lint
     module Validators
-      # Tags validators - validate YARD tag quality and consistency
       module Tags
         # RedundantParamDescription validator
         #

data/lib/yard/lint/validators/warnings/duplicated_parameter_name/config.rb

@@ -5,7 +5,6 @@ module Yard
     module Validators
       # Validators for checking YARD warnings
       module Warnings
-        # Validator for detecting duplicated parameter names in @param tags
         module DuplicatedParameterName
           # Configuration for DuplicatedParameterName validator
           class Config < ::Yard::Lint::Validators::Config

data/lib/yard/lint/validators/warnings/duplicated_parameter_name.rb

@@ -3,7 +3,6 @@
 module Yard
   module Lint
     module Validators
-      # Validators for checking YARD warnings
       module Warnings
         # DuplicatedParameterName validator
         #
@@ -29,7 +28,6 @@ module Yard
         #
         #     Warnings/DuplicatedParameterName:
         #       Enabled: false
-        #
         module DuplicatedParameterName
         end
       end

data/lib/yard/lint/validators/warnings/invalid_directive_format/config.rb

@@ -3,9 +3,7 @@
 module Yard
   module Lint
     module Validators
-      # Validators for checking YARD warnings
       module Warnings
-        # Validator for detecting invalid directive formats
         module InvalidDirectiveFormat
           # Configuration for InvalidDirectiveFormat validator
           class Config < ::Yard::Lint::Validators::Config

data/lib/yard/lint/validators/warnings/invalid_directive_format.rb

@@ -3,7 +3,6 @@
 module Yard
   module Lint
     module Validators
-      # Validators for checking YARD warnings
       module Warnings
         # InvalidDirectiveFormat validator
         #
@@ -29,7 +28,6 @@ module Yard
         #
         #     Warnings/InvalidDirectiveFormat:
         #       Enabled: false
-        #
         module InvalidDirectiveFormat
         end
       end

data/lib/yard/lint/validators/warnings/invalid_tag_format/config.rb

@@ -3,9 +3,7 @@
 module Yard
   module Lint
     module Validators
-      # Validators for checking YARD warnings
       module Warnings
-        # Validator for detecting invalid tag formats
         module InvalidTagFormat
           # Configuration for InvalidTagFormat validator
           class Config < ::Yard::Lint::Validators::Config

data/lib/yard/lint/validators/warnings/invalid_tag_format.rb

@@ -3,7 +3,6 @@
 module Yard
   module Lint
     module Validators
-      # Validators for checking YARD warnings
       module Warnings
         # InvalidTagFormat validator
         #
@@ -29,7 +28,6 @@ module Yard
         #
         #     Warnings/InvalidTagFormat:
         #       Enabled: false
-        #
         module InvalidTagFormat
         end
       end

data/lib/yard/lint/validators/warnings/syntax_error/config.rb

@@ -3,9 +3,7 @@
 module Yard
   module Lint
     module Validators
-      # Validators for checking YARD warnings
       module Warnings
-        # Validator for detecting files YARD could not parse
         module SyntaxError
           # Configuration for SyntaxError validator
           class Config < ::Yard::Lint::Validators::Config

data/lib/yard/lint/validators/warnings/syntax_error.rb

@@ -3,7 +3,6 @@
 module Yard
   module Lint
     module Validators
-      # Validators for checking YARD warnings
       module Warnings
         # SyntaxError validator
         #
@@ -25,7 +24,6 @@ module Yard
         #
         #     Warnings/SyntaxError:
         #       Enabled: false
-        #
         module SyntaxError
         end
       end

data/lib/yard/lint/validators/warnings/unknown_directive/config.rb

@@ -3,9 +3,7 @@
 module Yard
   module Lint
     module Validators
-      # Validators for checking YARD warnings
       module Warnings
-        # Validator for detecting unknown directives
         module UnknownDirective
           # Configuration for UnknownDirective validator
           class Config < ::Yard::Lint::Validators::Config

data/lib/yard/lint/validators/warnings/unknown_directive.rb

@@ -3,7 +3,6 @@
 module Yard
   module Lint
     module Validators
-      # Validators for checking YARD warnings
       module Warnings
         # UnknownDirective validator
         #
@@ -30,7 +29,6 @@ module Yard
         #
         #     Warnings/UnknownDirective:
         #       Enabled: false
-        #
         module UnknownDirective
         end
       end

data/lib/yard/lint/validators/warnings/unknown_parameter_name/config.rb

@@ -3,9 +3,7 @@
 module Yard
   module Lint
     module Validators
-      # Validators for checking YARD warnings
       module Warnings
-        # Validator for detecting unknown parameter names in @param tags
         module UnknownParameterName
           # Configuration for UnknownParameterName validator
           class Config < ::Yard::Lint::Validators::Config

data/lib/yard/lint/validators/warnings/unknown_parameter_name.rb

@@ -3,7 +3,6 @@
 module Yard
   module Lint
     module Validators
-      # Validators for checking YARD warnings
       module Warnings
         # UnknownParameterName validator
         #
@@ -27,7 +26,6 @@ module Yard
         #
         #     Warnings/UnknownParameterName:
         #       Enabled: false
-        #
         module UnknownParameterName
         end
       end

data/lib/yard/lint/validators/warnings/unknown_tag/config.rb

@@ -3,9 +3,7 @@
 module Yard
   module Lint
     module Validators
-      # Validators for checking YARD warnings
       module Warnings
-        # Validator for detecting unknown tags in documentation
         module UnknownTag
           # Configuration for UnknownTag validator
           class Config < ::Yard::Lint::Validators::Config

data/lib/yard/lint/validators/warnings/unknown_tag.rb

@@ -3,7 +3,6 @@
 module Yard
   module Lint
     module Validators
-      # Validators for checking YARD warnings
       module Warnings
         # UnknownTag validator
         #
@@ -40,7 +39,6 @@ module Yard
         #
         #     Warnings/UnknownTag:
         #       Enabled: false
-        #
         module UnknownTag
         end
       end

data/lib/yard/lint/version.rb

@@ -3,6 +3,6 @@
 module Yard
   module Lint
     # @return [String] version of the YARD Lint gem
-    VERSION = '1.9.0'
+    VERSION = '1.10.1'
   end
 end

data/lib/yard/lint.rb

@@ -10,6 +10,7 @@ require 'did_you_mean'
 require 'yard'
 require 'set'
 
+# YARD Lint - comprehensive linter for YARD documentation
 module Yard
   # YARD Lint module providing linting functionality for YARD documentation
   module Lint

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yard-lint
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.10.1
 platform: ruby
 authors:
 - Maciej Mensfeld
@@ -85,6 +85,12 @@ files:
 - lib/yard/lint/validators/documentation/blank_line_before_definition/parser.rb
 - lib/yard/lint/validators/documentation/blank_line_before_definition/result.rb
 - lib/yard/lint/validators/documentation/blank_line_before_definition/validator.rb
+- lib/yard/lint/validators/documentation/duplicate_namespace_comment.rb
+- lib/yard/lint/validators/documentation/duplicate_namespace_comment/config.rb
+- lib/yard/lint/validators/documentation/duplicate_namespace_comment/messages_builder.rb
+- lib/yard/lint/validators/documentation/duplicate_namespace_comment/parser.rb
+- lib/yard/lint/validators/documentation/duplicate_namespace_comment/result.rb
+- lib/yard/lint/validators/documentation/duplicate_namespace_comment/validator.rb
 - lib/yard/lint/validators/documentation/empty_comment_line.rb
 - lib/yard/lint/validators/documentation/empty_comment_line/config.rb
 - lib/yard/lint/validators/documentation/empty_comment_line/messages_builder.rb
@@ -313,7 +319,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.16
 specification_version: 4
 summary: YARD documentation linter and validator
 test_files: []