Improve documentation

lib/src/lock.dart

@@ -101,7 +101,7 @@ class Lock extends _Lock {
 }
 
 /// An [UnfairLock] object is identical to a [Lock] excepts that it wakes up the
-/// last future that called [acquire] instead of the first (waiting futures are
+/// last future that called [acquire] instead of the first (i.e. waiting futures are
 /// put in a LIFO queue).
 class UnfairLock extends _Lock {
   /// Create a new [UnfairLock] object.

lib/src/semaphore.dart

@@ -115,11 +115,8 @@ class BoundedSemaphore extends Semaphore {
       : _initial = value,
         super(value);
 
-  /// Release a permit from the semaphore.
-  ///
-  /// This method releases a permit from the semaphore, allowing other threads to
-  /// acquire it. If the value of the semaphore is greater than the initial value,
-  /// a [BoundedSemaphoreLimitException] is thrown.
+  /// Release a permit from the semaphore. If the value of the semaphore is greater than the
+  /// initial value, a [BoundedSemaphoreLimitException] is thrown.
   @override
   void release() {
     super.release();