Remove .ruby-version file

This PR removes the `.ruby-version` file

The goal is to prevent forcing a specific Ruby version on contributors. Developers should be able to work on this repository regardless of their local Ruby version.

* Previously, the Ruby version was pinned solely to address inconsistencies in hash syntax during documentation generation, not due to internal logic issues.
* I believe pinning the version for this reason is not ideal.
* With this change, documentation generation now produce consistent results without relying on a fixed Ruby version.
* Contributors no longer need to worry about or strictly adhere to a specific Ruby version.

Author: ydah

.github/workflows/main.yml

@@ -18,6 +18,7 @@ jobs:
       - uses: actions/checkout@v6
       - uses: ruby/setup-ruby@v1
         with:
+          ruby-version: ruby
           bundler-cache: true
       - run: bundle exec rake confirm_config documentation_syntax_check confirm_documentation
 
@@ -53,6 +54,7 @@ jobs:
       - uses: actions/checkout@v6
       - uses: ruby/setup-ruby@v1
         with:
+          ruby-version: ruby
           bundler-cache: true
       - run: bundle exec rake spec
 
@@ -72,6 +74,7 @@ jobs:
           cat Gemfile.local
       - uses: ruby/setup-ruby@v1
         with:
+          ruby-version: ruby
           bundler-cache: true
       - name: Show RuboCop version
         run: grep '^    rubocop' Gemfile.lock | sort
@@ -93,6 +96,7 @@ jobs:
           cat Gemfile.local
       - uses: ruby/setup-ruby@v1
         with:
+          ruby-version: ruby
           bundler-cache: true
       - name: Show RuboCop version
         run: grep '^    rubocop' Gemfile.lock | sort
@@ -115,6 +119,7 @@ jobs:
           EOF
       - uses: ruby/setup-ruby@v1
         with:
+          ruby-version: ruby
           bundler-cache: true
       - run: NO_COVERAGE=true bundle exec rake spec
 

.gitignore

@@ -16,6 +16,7 @@ pkg
 /vendor
 
 .ruby-gemset
+.ruby-version
 
 # simplecov generated
 coverage

.ruby-version

@@ -5,6 +5,48 @@ require 'rubocop-rspec'
 require 'rubocop/cops_documentation_generator'
 require 'yard'
 
+# Monkey patch to normalize Hash formatting regardless of Ruby version
+class CopsDocumentationGenerator
+  private
+
+  # Override to normalize Hash values to Ruby 3.4+ format
+  def format_table_value(val)
+    value =
+      case val
+      when Array
+        if val.empty?
+          '`[]`'
+        else
+          val.map { |config| format_table_value(config) }.join(', ')
+        end
+      when Hash
+        # Normalize Hash to Ruby 3.4+ format with spaces around =>
+        normalize_hash(val)
+      else
+        wrap_backtick(val.nil? ? '<none>' : val)
+      end
+    value.gsub("#{@base_dir}/", '').rstrip
+  end
+
+  def normalize_hash(hash)
+    return '`{}`' if hash.empty?
+
+    pairs = hash.map do |key, value|
+      formatted_key = key.inspect
+      formatted_value = value.is_a?(String) ? value.inspect : value.to_s
+
+      # Use symbol colon syntax for symbol keys, hash rocket for others
+      if key.is_a?(Symbol)
+        "#{key}: #{formatted_value}"
+      else
+        "#{formatted_key} => #{formatted_value}"
+      end
+    end
+
+    "`{#{pairs.join(', ')}}`"
+  end
+end
+
 YARD::Rake::YardocTask.new(:yard_for_generate_documentation) do |task|
   task.files = ['lib/rubocop/cop/**/*.rb']
   task.options = ['--no-output']