Update documentation of BaseCollection class

docs/Collection/BaseCollection.md

@@ -2,15 +2,16 @@
 
 Common and useful classes, methods, exceptions etc.
 
-# Collection
+# BaseCollection
 
 ### Namespace
 
-`Meritoo\Common\Collection\Collection`
+`Meritoo\Common\Collection\BaseCollection`
 
 ### Info
 
-It's a set of some elements, e.g. objects. It's iterable and countable. Provides very useful methods. Some of them:
+It's a set of some elements with the same type, e.g. objects. It's iterable and countable. Provides very useful
+methods. Some of them:
 - `getFirst()` - returns the first element in the collection
 - `getLast()` - returns the last element in the collection
 - `isEmpty()` - returns information if collection is empty
@@ -19,21 +20,49 @@ It's a set of some elements, e.g. objects. It's iterable and countable. Provides
 - `prepend($element)` - prepends given element (adds given element at the beginning of collection)
 - `remove($element)` - removes given element
 
-Examples of usage below.
+### Implementation
 
-### An empty collection
+You have to implement:
 
 ```php
-use Meritoo\Common\Collection\Collection;
-
-$emptyCollection = new Collection();
-var_dump($emptyCollection->isEmpty()); // bool(true)
+abstract protected function isValidType($element): bool;
 ```
 
-### Simple collection
+This method verifies 1 element before it will be added to collection. Returns information if the element has valid,
+expected type.
+
+Example (from `Meritoo\Common\Collection\Templates` class):
 
 ```php
-use Meritoo\Common\Collection\Collection;
+protected function isValidType($element): bool
+{
+    return $element instanceof Template;
+}
+```
+
+### Methods to overwrite
+
+You can, if you wish, overwrite these methods:
+
+1. To prepare elements used to initialize the collection in your own way:
+
+    ```php
+    protected function prepareElements(array $elements): array
+    ```
+
+2. To validate type of elements in your own way:
+
+    ```php
+    protected function getElementsWithValidType(array $elements): array
+    ```
+
+### Examples of usage
+
+```php
+use Meritoo\Common\Collection\StringCollection;
+
+$emptyCollection = new StringCollection();
+var_dump($emptyCollection->isEmpty()); // bool(true)
 
 $elements = [
     'lorem',
@@ -42,14 +71,14 @@ $elements = [
     345 => 'sit',
 ];
 
-$simpleCollection = new Collection($elements);
+$simpleCollection = new StringCollection($elements);
 var_dump($simpleCollection->has('dolor')); // bool(true)
 ```
 
 # More
 
 1. [Base test case (with common methods and data providers)](../Base-test-case.md)
-2. [**Collection of elements**](Collection.md)
+2. [**Collection of elements**](BaseCollection.md)
 3. [Templates](Templates.md)
 4. [Exceptions](../Exceptions.md)
 5. [Static methods](../Static-methods.md)

docs/Collection/Templates.md

@@ -54,7 +54,7 @@ Throws an `Meritoo\Common\Exception\ValueObject\Template\TemplateNotFoundExcepti
 # More
 
 1. [Base test case (with common methods and data providers)](../Base-test-case.md)
-2. [Collection of elements](Collection.md)
+2. [Collection of elements](BaseCollection.md)
 3. [**Templates**](Templates.md)
 4. [Exceptions](../Exceptions.md)
 5. [Static methods](../Static-methods.md)