Fix wording

README.md

@@ -27,7 +27,7 @@ Task {
 semaphore.signal()
 ```
 
-An actor can use a semaphore in order to make its methods can't run concurrently:
+An actor can use a semaphore so that its methods can't run concurrently, avoiding the "actor reentrancy problem":
 
 ```swift
 actor MyActor {

Sources/Semaphore/AsyncSemaphore.swift

@@ -195,7 +195,8 @@ public final class AsyncSemaphore: @unchecked Sendable {
             // the current task is cancelled), or call it later (if the task is
             // cancelled later). In the first case, we're still holding the lock,
             // waiting for the continuation. In the second case, we do not hold
-            // the  This is the reason why we use a recursive lock.
+            // the lock. Being able to handle both situations is the reason why
+            // we use a recursive lock.
             lock()
             defer { unlock() }
 

Sources/Semaphore/Documentation.docc/Documentation.md

@@ -25,7 +25,7 @@ Task {
 semaphore.signal()
 ```
 
-An actor can use a semaphore in order to make its methods can't run concurrently:
+An actor can use a semaphore so that its methods can't run concurrently, avoiding the "actor reentrancy problem":
 
 ```swift
 actor MyActor {