diff --git a/.phpdoc/guide/changelog.rst b/.phpdoc/guide/changelog.rst
index 00d0f88..ab8d7be 100644
--- a/.phpdoc/guide/changelog.rst
+++ b/.phpdoc/guide/changelog.rst
@@ -3,32 +3,35 @@
Changelog
#########
-* :ref:`v2-0-0`
-* :ref:`v1-1-0`
-* :ref:`v1-0-1`
-* :ref:`v1-0-0`
-
-.. _v2-0-0:
+.. contents::
v2.0.0
======
**Breaking Changes:**
-* Raised minimum PHP version from 8.0 to 8.1
-* Renamed traits for :php:namespace:`OCC\Basics\Interfaces` and moved to different namespace
+* Raised minimum PHP version from 8.0 to 8.1 in order to use `new features `_ like
+ `array_is_list() `_ and the spread operator on string-keyed arrays
+* :php:namespace:`OCC\Basics\Interfaces` traits renamed and moved to different namespace
+
+ .. code-block::
+ OCC\Basics\InterfaceTraits\ArrayAccess -> OCC\Basics\Interfaces\ArrayAccessTrait
+ OCC\Basics\InterfaceTraits\Countable -> OCC\Basics\Interfaces\CountableTrait
+ OCC\Basics\InterfaceTraits\IteratorAggregate -> OCC\Basics\Interfaces\IteratorAggregateTrait
+ OCC\Basics\InterfaceTraits\Iterator -> OCC\Basics\Interfaces\IteratorTrait
+
* Renamed internal methods for :php:trait:`OCC\Basics\Traits\Getter` and :php:trait:`OCC\Basics\Traits\Setter` to avoid
- confusion with regular class method
+ confusion with regular class methods
.. code-block:: php
// old methods
- protected function magicGet{PascalCasePropertyName}(): mixed
- protected function magicSet{PascalCasePropertyName}(mixed $value): void
+ function magicGet{PascalCasePropertyName}(): mixed
+ function magicSet{PascalCasePropertyName}(mixed $value): void
.. code-block:: php
// new methods
- protected function _magicGet{PascalCasePropertyName}(): mixed
- protected function _magicSet{PascalCasePropertyName}(mixed $value): void
+ function _magicGet{PascalCasePropertyName}(): mixed
+ function _magicSet{PascalCasePropertyName}(mixed $value): void
**New Features:**
@@ -39,8 +42,6 @@ v2.0.0
* Extended API for all datastructures
* Extended `documentation `_
-.. _v1-1-0:
-
v1.1.0
======
@@ -57,8 +58,6 @@ v1.1.0
// new constructor signature
public function __construct(array $allowedTypes = [])
-.. _v1-0-1:
-
v1.0.1
======
@@ -66,8 +65,6 @@ v1.0.1
* Improved exception handling in :php:trait:`Singleton ` trait
-.. _v1-0-0:
-
v1.0.0
======
diff --git a/.phpdoc/guide/index.rst b/.phpdoc/guide/index.rst
index e3f6b33..c2a08f9 100644
--- a/.phpdoc/guide/index.rst
+++ b/.phpdoc/guide/index.rst
@@ -4,12 +4,11 @@ Documentation
#############
.. meta::
- :layout: landingpage
+ :layout: landingpage
.. toctree::
- :hidden:
- :titlesonly:
+ :hidden:
- overview/index
- usage/index
- changelog
+ overview/index
+ usage/index
+ changelog
diff --git a/.phpdoc/guide/usage/installation.rst b/.phpdoc/guide/usage/installation.rst
index c0dcfbd..ad96dc2 100644
--- a/.phpdoc/guide/usage/installation.rst
+++ b/.phpdoc/guide/usage/installation.rst
@@ -3,6 +3,54 @@
Installation
############
+Composer
+========
+
+The intended and recommended way of re-using this package is via `Composer `_. The following
+command will get you the latest version and make it a dependency of your project. It will also register all classes and
+traits with the autoloader to make them available inside the application.
+
.. code-block:: shell
- composer require opencultureconsulting/basics
+ # This will install the latest stable version suitable for your project
+ composer require "opencultureconsulting/basics"
+
+If you want to use a specific version other than the latest available for your environment, you can do so by appending
+the desired version constraint:
+
+.. code-block:: shell
+
+ # This will install the latest patch level version of 2.0 (i. e. >=2.0.0 && <2.1.0)
+ composer require "opencultureconsulting/basics:~2.0"
+
+All available versions as well as further information about :doc:`requirements` and dependencies can be found on
+`Packagist `_.
+
+Git
+===
+
+Alternatively, you can fetch the files from `GitHub `_ and add
+them to your project manually. The best way is by cloning the repository, because then you can easily update to a newer
+version by just pulling the changes and checking out a different version tag.
+
+.. code-block:: shell
+
+ # This will clone the repository into the "basics" directory
+ git clone https://github.com/opencultureconsulting/php-basics.git basics
+
+If you want to use a specific version other than the latest development state, you have to specify the desired tag as
+well:
+
+.. code-block:: shell
+
+ # This will clone the repository state at version "2.0.0" into the "basics" directory
+ git clone --branch=v2.0.0 https://github.com/opencultureconsulting/php-basics.git basics
+
+Be aware that you also need to make the classes and traits available in your application by either adding them to your
+autoloader or by including all files individually in PHP.
+
+Download
+========
+
+As a last resort you can also just download the files. You can find all available versions as well as the current
+development state on the `GitHub release page `_.
diff --git a/.phpdoc/guide/usage/requirements.rst b/.phpdoc/guide/usage/requirements.rst
index 5f8a60d..a46e1a2 100644
--- a/.phpdoc/guide/usage/requirements.rst
+++ b/.phpdoc/guide/usage/requirements.rst
@@ -3,5 +3,16 @@
Requirements
############
-PHP 8.1
-Composer 2
+Environment
+===========
+
+This package requires at least **PHP 8.1**.
+
+It is highly recommended to use `Composer `_ for dependency management and autoloading,
+although it is technically not strictly required for re-using any of these classes and traits. But it certainly
+makes it a lot easier!
+
+Dependencies
+============
+
+This package does not have any external dependencies.
diff --git a/doc/classes/OCC-Basics-DataStructures-StrictCollection.html b/doc/classes/OCC-Basics-DataStructures-StrictCollection.html
index b4dbb74..a73c5a9 100644
--- a/doc/classes/OCC-Basics-DataStructures-StrictCollection.html
+++ b/doc/classes/OCC-Basics-DataStructures-StrictCollection.html
@@ -142,8 +142,8 @@
-