yard-lint 1.9.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba0156cdfc89e9d83eb44c650fc7577e68256717646470736a1a5051d45c8830
-  data.tar.gz: f12452f074b35d19f8edaf2fe4d4e28dcda832e0b355b500980e21e97b96c71b
+  metadata.gz: 37286ca0e1a4253fd44af81beda164e713f58903e9d7c06ccf7dc06484c76be9
+  data.tar.gz: 2b5b3dc5eaed758b12b07a5a2a67ad537dbf56e8459a5075e796850a73deb2a2
 SHA512:
-  metadata.gz: 1d453260f7016fcdb0f678d22349ffd922eb941f7daec2393bde3c81798bee88669cd003134f72c8a85fc44c700953e72c10d3ca930df96b33d15efbff1cbaf9
-  data.tar.gz: 5b0f7a4c24095a2db9d5c584029a23e2ff49dfcdd01c534ce5ac9922d2d8c5206f0137046815d5b9bfbffb3be4dff908df9409a99842db9234dd81c1471dceb6
+  metadata.gz: ca788e4ee2a91c5990b20c953bf28bfeaa731c6feaa4183a3bb323e04f5a198af40a7f30d60e4a714d9361a0ab589a9c202f766202e7c6468ad7c7407b55d5ea
+  data.tar.gz: a38ddad77479fdcc11f18d530fafacd090d079827a1e93ad423f2dc839e5e50cc072ab04a7a2150836f4f654f560e098abf6e59c5b38d970f6d93d39a373b8cf

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 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/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.0'
   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.0
 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: []