From 2c815dbcb2ea1c1e6e86ed8d6d2962892b96acf4 Mon Sep 17 00:00:00 2001
From: Alexandr Bulancov <6594487+trinistr@users.noreply.github.com>
Date: Fri, 4 Jul 2025 17:15:49 +0300
Subject: [PATCH] Fix mistakes in MVar documentation

---
 .github/CONTRIBUTING.md                | 4 ++--
 lib/concurrent-ruby/concurrent/mvar.rb | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index a865b48b3..0f6450e5c 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -66,7 +66,7 @@ There are a few guidelines which we follow when adding features. Consider that s
 
 #### Write Documentation
 
-Document any external behavior in the [README](README.md).
+Document any external behavior in the [README](../README.md).
 
 #### Commit Changes
 
@@ -106,7 +106,7 @@ git push origin my-feature-branch -f
 
 #### Update CHANGELOG
 
-Update the [CHANGELOG](CHANGELOG.md) with a description of what you have changed.
+Update the [CHANGELOG](../CHANGELOG.md) with a description of what you have changed.
 
 #### Check on Your Pull Request
 
diff --git a/lib/concurrent-ruby/concurrent/mvar.rb b/lib/concurrent-ruby/concurrent/mvar.rb
index dfc41950c..9777ba347 100644
--- a/lib/concurrent-ruby/concurrent/mvar.rb
+++ b/lib/concurrent-ruby/concurrent/mvar.rb
@@ -9,7 +9,7 @@ module Concurrent
   # queue of length one, or a special kind of mutable variable.
   #
   # On top of the fundamental `#put` and `#take` operations, we also provide a
-  # `#mutate` that is atomic with respect to operations on the same instance.
+  # `#modify` that is atomic with respect to operations on the same instance.
   # These operations all support timeouts.
   #
   # We also support non-blocking operations `#try_put!` and `#try_take!`, a
@@ -87,7 +87,7 @@ def borrow(timeout = nil)
       @mutex.synchronize do
         wait_for_full(timeout)
 
-        # if we timeoud out we'll still be empty
+        # If we timed out we'll still be empty
         if unlocked_full?
           yield @value
         else
@@ -116,10 +116,10 @@ def put(value, timeout = nil)
     end
 
     # Atomically `take`, yield the value to a block for transformation, and then
-    # `put` the transformed value. Returns the transformed value. A timeout can
+    # `put` the transformed value. Returns the pre-transform value. A timeout can
     # be set to limit the time spent blocked, in which case it returns `TIMEOUT`
     # if the time is exceeded.
-    # @return [Object] the transformed value, or `TIMEOUT`
+    # @return [Object] the pre-transform value, or `TIMEOUT`
     def modify(timeout = nil)
       raise ArgumentError.new('no block given') unless block_given?