🎨 Upgrade dev dependencies

- Improve documentation

Author: pboling

Gemfile

@@ -27,8 +27,6 @@ platform :mri do
 
   # Dev Console - Binding.pry - Irb replacement
   gem "pry", "~> 0.14"                     # ruby >= 2.0
-
-  gem "reek", "~> 6.4"
 end
 
 # Security Audit

Gemfile.lock

@@ -123,11 +123,11 @@ GEM
     rspec-expectations (3.13.4)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.3)
+    rspec-mocks (3.13.4)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.3)
-    rubocop (1.75.4)
+    rubocop (1.75.5)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -252,10 +252,11 @@ DEPENDENCIES
   reek (~> 6.4)
   rspec (~> 3.13)
   rspec-block_is_expected (~> 1.0)
+  rubocop (~> 1.73, >= 1.73.2)
   rubocop-lts (~> 8.1, >= 8.1.1)
   rubocop-packaging (~> 0.5, >= 0.5.2)
   rubocop-rspec (~> 3.2)
-  standard (>= 1.35.1, != 1.42.0, != 1.41.1)
+  standard (~> 1.47)
   stone_checksums (~> 1.0)
   version_gem!
   yard (~> 0.9, >= 0.9.37)

gemfiles/modular/style.gemfile

@@ -3,10 +3,12 @@
 # We run rubocop on the latest version of Ruby,
 #   but in support of the oldest supported version of Ruby
 
+gem "reek", "~> 6.4"
+gem "rubocop", "~> 1.73", ">= 1.73.2"
 gem "rubocop-lts", "~> 8.1", ">= 8.1.1" # Linting for Ruby >= 2.2
 gem "rubocop-packaging", "~> 0.5", ">= 0.5.2"
 gem "rubocop-rspec", "~> 3.2"
-gem "standard", ">= 1.35.1", "!= 1.41.1", "!= 1.42.0"
+gem "standard", "~> 1.47"
 
 # Std Lib extractions
 gem "benchmark", "~> 0.4" # Removed from Std Lib in Ruby 3.5

lib/version_gem/epoch.rb

@@ -18,6 +18,7 @@ def extended(base)
       end
     end
 
+    # Tweak the basic API so it will support Epoch Semantic Versioning
     module OverloadApiForEpoch
       # *** OVERLOAD METHODS FROM API ***
       #

lib/version_gem/error.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
 module VersionGem
+  # Errors raised by VersionGem will be of this class
   class Error < RuntimeError; end
 end

lib/version_gem/rspec.rb

@@ -59,6 +59,7 @@
   end
 end
 
+# This one is more Epoch ;)
 RSpec.shared_examples_for("an Epoch Version module") do |version_mod|
   it "is introspectable" do
     aggregate_failures "introspectable api" do

lib/version_gem/ruby.rb

@@ -5,11 +5,13 @@ module VersionGem
   module Ruby
     RUBY_VER = ::Gem::Version.new(RUBY_VERSION)
 
+    # Check if the current Ruby version is greater than or equal to the given version
     def gte_minimum_version?(version, engine = "ruby")
       RUBY_VER >= ::Gem::Version.new(version) && ::RUBY_ENGINE == engine
     end
     module_function :gte_minimum_version?
 
+    # Check if the current Ruby version (MAJOR.MINOR) is equal to the given version
     def actual_minor_version?(major, minor, engine = "ruby")
       major.to_i == RUBY_VER.segments[0] &&
         minor.to_i == RUBY_VER.segments[1] &&

version_gem.gemspec

@@ -47,7 +47,7 @@ Gem::Specification.new do |spec|
 
   spec.files = Dir[
     # Files (alphabetical)
-    "lib/**/*"
+    "lib/**/*",
   ]
   # Automatically included with gem package, no need to list again in files.
   spec.extra_rdoc_files = Dir[