improve the readability of the documentation

Author: pdscopes

CONTRIBUTING.md

@@ -1,5 +1,6 @@
-Contributions are welcome, if you find a bug please fork from the master branch and submit a pull request.
+Contributions are welcome. If you find a bug, please fork from the main branch and submit a pull request.
 
-Alternatively you can open an issue however these are likely to take longer to resolve.
+Alternatively, you can open an issue; however, these are likely to take longer to resolve.
 
-We are not currently looking to add new functionality to the library, however if there is something you believe is missing please open an issue and we can discuss it!
+We are not currently looking to add new functionality to the library.
+However, if there is something you believe is missing, please open an issue and we can discuss it!

src/Arr.php

@@ -12,7 +12,7 @@
 class Arr
 {
     /**
-     * Determines if $value is an accessible like an array.
+     * Determines if $value is an accessible-like an array.
      *
      * @param mixed $value
      *
@@ -53,7 +53,7 @@ public static function divide($array): array
     }
 
     /**
-     * Flatten a multi-dimensional array into a single level.
+     * Flatten a multidimensional array into a single level.
      *
      * @param Arrayable|array $array
      * @param int $depth
@@ -266,7 +266,7 @@ public static function search(array $haystack, $needle, bool $strict = false)
     }
 
     /**
-     * Given a multi-dimensional array, return the first item that has a property $property
+     * Given a multidimensional array, return the first item that has a property $property
      * with value $value.
      * An array of properties can be provided to perform deeper finds.
      *

src/ArrDots.php

@@ -12,7 +12,7 @@
 class ArrDots
 {
     /**
-     * Implode a multi-dimensional associative array into a single level dots array.
+     * Implode a multidimensional associative array into a single level dots array.
      *
      * @param array $array
      * @param string $prepend
@@ -35,7 +35,7 @@ public static function implode(array $array, string $prepend = ''): array
     }
 
     /**
-     * Explode a single level dots array into a multi-dimensional associative array.
+     * Explode a single level dots array into a multidimensional associative array.
      *
      * @param array $array
      *
@@ -131,7 +131,7 @@ public static function remove(&$array, $keys)
     }
 
     /**
-     * Get an item from a multi-dimensional associative array using "dots" notation.
+     * Get an item from a multidimensional associative array using "dots" notation.
      *
      * @param ArrayAccess|array $array
      * @param string|int $key
@@ -165,7 +165,7 @@ public static function get($array, $key, $default = null)
     }
 
     /**
-     * Get all items from a multi-dimensional associative array using "dots" notation and
+     * Get all items from a multidimensional associative array using "dots" notation and
      * return a flattened "dots" notation array.
      *
      * @param ArrayAccess|array $array
@@ -214,7 +214,7 @@ public static function collate($array, string $key, string $wildcard = null): ar
     }
 
     /**
-     * Determine if an item or items exist in an multi-dimensional associative array using "dots" notation.
+     * Determine if an item or items exist in a multidimensional associative array using "dots" notation.
      *
      * @param ArrayAccess|array $array
      * @param string|string[] $keys
@@ -234,7 +234,7 @@ public static function has($array, $keys, string $wildcard = null): bool
         foreach ((array)$keys as $key) {
             $array = $originalArray;
 
-            // If the array has the key carry on
+            // If the array has the key, carry on
             if (Arr::exists($array, $key)) {
                 continue;
             }
@@ -244,7 +244,7 @@ public static function has($array, $keys, string $wildcard = null): bool
             foreach ($segments as $k => $segment) {
                 // If the segment is a wildcard
                 if ($segment === $wildcard && !empty($array)) {
-                    // If this is the last segment then the array has the key
+                    // If this is the last segment, then the array has the key
                     if ($k + 1 === count($segments)) {
                         break;
                     }
@@ -292,7 +292,7 @@ public static function pull(&$array, string $key, $default = null)
     }
 
     /**
-     * Set an multi-dimensional associative array item to $value using "dots" notation.
+     * Set a multidimensional associative array item to $value using "dots" notation.
      *
      * @param array $array
      * @param ?string $key
@@ -324,7 +324,7 @@ public static function set(array &$array, ?string $key, $value)
     }
 
     /**
-     * Get a subset of items from an multi-dimensional associative $array using "dots" notation for $keys.
+     * Get a subset of items from a multidimensional associative $array using "dots" notation for $keys.
      *
      * @param array $array
      * @param string|string[] $keys
@@ -339,7 +339,7 @@ public static function only(array $array, $keys): array
     }
 
     /**
-     * Given a multi-dimensional array, return the first item that has a property $property
+     * Given a multidimensional array, return the first item that has a property $property
      * with value $value.
      * An array of properties can be provided to perform deeper finds.
      *