Fixed the documentation.

src/Collection.php

@@ -13,21 +13,21 @@ interface Collection extends \Traversable, \Countable, \JsonSerializable
     /**
      * Removes all values from the collection.
      */
-    function clear();
+    public function clear();
 
     /**
      * Returns the size of the collection.
      *
      * @return int
      */
-    function count(): int;
+    public function count(): int;
 
     /**
      * Returns a shallow copy of the collection.
      *
      * @return Collection a copy of the collection.
      */
-    function copy(): Collection;
+    public function copy(): Collection;
 
     /**
      * Returns whether the collection is empty.
@@ -37,7 +37,7 @@ function copy(): Collection;
      *
      * @return bool
      */
-    function isEmpty(): bool;
+    public function isEmpty(): bool;
 
     /**
      * Returns an array representation of the collection.
@@ -48,5 +48,5 @@ function isEmpty(): bool;
      *
      * @return array
      */
-    function toArray(): array;
+    public function toArray(): array;
 }

src/Hashable.php

@@ -20,15 +20,15 @@ interface Hashable
      *
      * @return mixed
      */
-    function hash();
+    public function hash();
 
     /**
      * Determines if two objects should be considered equal. Both objects will
      * be instances of the same class but may not be the same instance.
      *
-     * @param $obj An instance of the same class to compare to.
+     * @param $obj self An instance of the same class to compare to.
      *
      * @return bool
      */
-    function equals($obj): bool;
+    public function equals($obj): bool;
 }

src/Map.php

@@ -393,6 +393,10 @@ public function reduce(callable $callback, $initial = null)
     /**
      * Completely removes a pair from the internal array by position. It is
      * important to remove it from the array and not just use 'unset'.
+     *
+     * @param int $position
+     *
+     * @return mixed
      */
     private function delete(int $position)
     {
@@ -434,9 +438,7 @@ public function remove($key, $default = null)
     }
 
     /**
-     * Returns a reversed copy of the map.
-     *
-     * @return Map
+     * Sorts the map into the reversed order.
      */
     public function reverse()
     {

src/Pair.php

@@ -88,8 +88,10 @@ public function jsonSerialize()
 
     /**
      * Returns a string representation of the pair.
+     *
+     * @return string a string representation of the pair.
      */
-    public function __toString()
+    public function __toString(): string
     {
         return 'object(' . get_class($this) . ')';
     }

src/PriorityQueue.php

@@ -50,7 +50,7 @@ public function clear()
     /**
      * @inheritDoc
      */
-    public function copy(): \Ds\Collection
+    public function copy(): Collection
     {
         $copy = new PriorityQueue();
 

src/Queue.php

@@ -65,7 +65,7 @@ public function clear()
     /**
      * @inheritDoc
      */
-    public function copy(): \Ds\Collection
+    public function copy(): Collection
     {
         return new self($this->deque);
     }
@@ -81,7 +81,7 @@ public function count(): int
     /**
      * Returns the value at the front of the queue without removing it.
      *
-     * @return
+     * @return mixed
      */
     public function peek()
     {

src/Sequence.php

@@ -20,22 +20,22 @@ interface Sequence extends Collection
      *                      allocated. Capacity will stay the same if this value
      *                      is less than or equal to the current capacity.
      */
-    function allocate(int $capacity);
+    public function allocate(int $capacity);
 
     /**
      * Updates every value in the sequence by applying a callback, using the
      * return value as the new value.
      *
      * @param callable $callback Accepts the value, returns the new value.
      */
-    function apply(callable $callback);
+    public function apply(callable $callback);
 
     /**
      * Returns the current capacity of the sequence.
      *
      * @return int
      */
-    function capacity(): int;
+    public function capacity(): int;
 
     /**
      * Determines whether the sequence contains all of zero or more values.
@@ -45,7 +45,7 @@ function capacity(): int;
      * @return bool true if at least one value was provided and the sequence
      *              contains all given values, false otherwise.
      */
-    function contains(...$values): bool;
+    public function contains(...$values): bool;
 
     /**
      * Returns a new sequence containing only the values for which a callback
@@ -57,7 +57,7 @@ function contains(...$values): bool;
      *
      * @return Sequence
      */
-    function filter(callable $callback = null): Sequence;
+    public function filter(callable $callback = null): Sequence;
 
     /**
      * Returns the index of a given value, or false if it could not be found.
@@ -66,7 +66,7 @@ function filter(callable $callback = null): Sequence;
      *
      * @return int|bool
      */
-    function find($value);
+    public function find($value);
 
     /**
      * Returns the first value in the sequence.
@@ -75,7 +75,7 @@ function find($value);
      *
      * @throws \UnderflowException if the sequence is empty.
      */
-    function first();
+    public function first();
 
     /**
      * Returns the value at a given index (position) in the sequence.
@@ -86,7 +86,7 @@ function first();
      *
      * @throws \OutOfRangeException if the index is not in the range [0, size-1]
      */
-    function get(int $index);
+    public function get(int $index);
 
     /**
      * Inserts zero or more values at a given index.
@@ -99,7 +99,7 @@ function get(int $index);
      *
      * @throws \OutOfRangeException if the index is not in the range [0, n]
      */
-    function insert(int $index, ...$values);
+    public function insert(int $index, ...$values);
 
     /**
      * Joins all values of the sequence into a string, adding an optional 'glue'
@@ -109,7 +109,7 @@ function insert(int $index, ...$values);
      *
      * @return string
      */
-    function join(string $glue = null): string;
+    public function join(string $glue = null): string;
 
     /**
      * Returns the last value in the sequence.
@@ -118,7 +118,7 @@ function join(string $glue = null): string;
      *
      * @throws \UnderflowException if the sequence is empty.
      */
-    function last();
+    public function last();
 
     /**
      * Returns a new sequence using the results of applying a callback to each
@@ -128,7 +128,7 @@ function last();
      *
      * @return Sequence
      */
-    function map(callable $callback): Sequence;
+    public function map(callable $callback): Sequence;
 
     /**
      * Returns the result of adding all given values to the sequence.
@@ -137,7 +137,7 @@ function map(callable $callback): Sequence;
      *
      * @return Sequence
      */
-    function merge($values): Sequence;
+    public function merge($values): Sequence;
 
     /**
      * Removes the last value in the sequence, and returns it.
@@ -146,14 +146,14 @@ function merge($values): Sequence;
      *
      * @throws \UnderflowException if the sequence is empty.
      */
-    function pop();
+    public function pop();
 
     /**
      * Adds zero or more values to the end of the sequence.
      *
      * @param mixed ...$values
      */
-    function push(...$values);
+    public function push(...$values);
 
     /**
      * Iteratively reduces the sequence to a single value using a callback.
@@ -166,7 +166,7 @@ function push(...$values);
      * @return mixed The carry value of the final iteration, or the initial
      *               value if the sequence was empty.
      */
-    function reduce(callable $callback, $initial = null);
+    public function reduce(callable $callback, $initial = null);
 
     /**
      * Removes and returns the value at a given index in the sequence.
@@ -177,19 +177,19 @@ function reduce(callable $callback, $initial = null);
      *
      * @throws \OutOfRangeException if the index is not in the range [0, size-1]
      */
-    function remove(int $index);
+    public function remove(int $index);
 
     /**
      * Reverses the sequence in-place.
      */
-    function reverse();
+    public function reverse();
 
     /**
      * Returns a reversed copy of the sequence.
      *
      * @return Sequence
      */
-    function reversed();
+    public function reversed();
 
     /**
      * Rotates the sequence by a given number of rotations, which is equivalent
@@ -198,7 +198,7 @@ function reversed();
      *
      * @param int $rotations The number of rotations (can be negative).
      */
-    function rotate(int $rotations);
+    public function rotate(int $rotations);
 
     /**
      * Replaces the value at a given index in the sequence with a new value.
@@ -208,7 +208,7 @@ function rotate(int $rotations);
      *
      * @throws \OutOfRangeException if the index is not in the range [0, size-1]
      */
-    function set(int $index, $value);
+    public function set(int $index, $value);
 
     /**
      * Removes and returns the first value in the sequence.
@@ -217,7 +217,7 @@ function set(int $index, $value);
      *
      * @throws \UnderflowException if the sequence was empty.
      */
-    function shift();
+    public function shift();
 
     /**
      * Returns a sub-sequence of a given length starting at a specified index.
@@ -240,15 +240,15 @@ function shift();
      *
      * @return Sequence
      */
-    function slice(int $index, int $length = null): Sequence;
+    public function slice(int $index, int $length = null): Sequence;
 
     /**
      * Sorts the sequence in-place, based on an optional callable comparator.
      *
      * @param callable|null $comparator Accepts two values to be compared.
      *                                  Should return the result of a <=> b.
      */
-    function sort(callable $comparator = null);
+    public function sort(callable $comparator = null);
 
     /**
      * Returns a sorted copy of the sequence, based on an optional callable
@@ -259,19 +259,19 @@ function sort(callable $comparator = null);
      *
      * @return Sequence
      */
-    function sorted(callable $comparator = null): Sequence;
+    public function sorted(callable $comparator = null): Sequence;
 
     /**
      * Returns the sum of all values in the sequence.
      *
      * @return int|float The sum of all the values in the sequence.
      */
-    function sum();
+    public function sum();
 
     /**
      * Adds zero or more values to the front of the sequence.
      *
      * @param mixed ...$values
      */
-    function unshift(...$values);
+    public function unshift(...$values);
 }

src/Set.php

@@ -101,7 +101,7 @@ public function contains(...$values): bool
     /**
      * @inheritDoc
      */
-    public function copy(): \Ds\Collection
+    public function copy(): Collection
     {
         return new self($this);
     }

src/Traits/Capacity.php

@@ -37,7 +37,7 @@ public function allocate(int $capacity)
     }
 
     /**
-     * @return the structures growth factor.
+     * @return float the structures growth factor.
      */
     protected function getGrowthFactor(): float
     {
@@ -92,15 +92,15 @@ protected function decreaseCapacity()
     }
 
     /**
-     * @return whether capacity should be increased.
+     * @return bool whether capacity should be increased.
      */
     protected function shouldDecreaseCapacity(): bool
     {
         return count($this) <= $this->capacity * $this->getTruncateThreshold();
     }
 
     /**
-     * @return whether capacity should be increased.
+     * @return bool whether capacity should be increased.
      */
     protected function shouldIncreaseCapacity(): bool
     {