Update docs and art

Author: david_smith

.gitattributes

@@ -7,8 +7,9 @@
 /CONTRIBUTING.md          export-ignore
 /docker-compose.yml       export-ignore
 /LICENSE.md               export-ignore
-/logo.png                 export-ignore
 /phpunit.xml              export-ignore
 /README.md                export-ignore
 /SECURITY.md              export-ignore
-/test.sh                  export-ignore
+/test.sh                  export-ignore
+/dock                     export-ignore
+/art/                     export-ignore

README.md

@@ -1,6 +1,6 @@
 # Zerotoprod\DataModelHelper
 
-![](./logo.png)
+![](art/logo.png)
 
 [![Repo](https://img.shields.io/badge/github-gray?logo=github)](https://github.com/zero-to-prod/data-model-helper)
 [![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/zero-to-prod/data-model-helper/test.yml?label=tests)](https://github.com/zero-to-prod/data-model-helper/actions)
@@ -11,16 +11,47 @@
 [![wakatime](https://wakatime.com/badge/github/zero-to-prod/data-model-helper.svg)](https://wakatime.com/badge/github/zero-to-prod/data-model-helper)
 [![Hits-of-Code](https://hitsofcode.com/github/zero-to-prod/data-model-helper?branch=main)](https://hitsofcode.com/github/zero-to-prod/data-model-helper/view?branch=main)
 
+## Contents
+
+- [Introduction](#introduction)
+- [Requirements](#requirements)
+- [Installation](#installation)
+- [Usage](#usage)
+    - [Including the Trait](#including-the-trait)
+- [Helper Methods](#helper-methods)
+    - [when](#when): Create a map of any type by using
+    - [mapOf](#mapof): Create a map of any type by using
+    - [pregReplace](#pregreplace): Perform a regular expression search and replace.
+    - [pregMatch](#pregmatch): Perform a regular expression match.
+    - [isUrl](#isurl): Validates a url.
+    - [isEmail](#isemail): Validates an email.
+    - [isMultiple](#ismultiple): Validate a value is a multiple of another.
+- [Local Development](#local-development)
+    - [Prerequisites](#prerequisites)
+    - [Initializing](#initializing)
+    - [Testing](#testing)
+    - [Configuration](#configuration)
+- [Contributing](#contributing)
+
+## Introduction
+
 Utilities for casting values using the [DataModel](https://github.com/zero-to-prod/data-model) package.
 
+## Requirements
+
+- PHP 8.1 or higher.
+- The [DataModel](https://github.com/zero-to-prod/data-model) Composer package
+
 ## Installation
 
-Install the package via Composer:
+Install `Zerotoprod\DataModelHelper` via [Composer](https://getcomposer.org/):
 
 ```bash
 composer require zero-to-prod/data-model-helper
 ```
 
+This will add the package to your project’s dependencies and create an autoloader entry for it.
+
 ## Usage
 
 ### Including the Trait
@@ -36,14 +67,6 @@ class DataModelHelper
 
 ## Helper Methods
 
-- [when](#when): Create a map of any type by using
-- [mapOf](#mapof): Create a map of any type by using
-- [pregReplace](#pregreplace): Perform a regular expression search and replace.
-- [pregMatch](#pregmatch): Perform a regular expression match.
-- [isUrl](#isurl): Validates a url.
-- [isEmail](#isemail): Validates an email.
-- [isMultiple](#ismultiple): Validate a value is a multiple of another.
-
 ### `when`
 
 Use `when` to call a function based on a condition.
@@ -364,11 +387,13 @@ echo $User->Aliases[0][1]->name; // Outputs: John Smith
 ```
 
 #### KeyBy
+
 Key an array by an element value by using the `key_by` argument.
 
 This also supports deep mapping.
 
 Note: this only applies to arrays.
+
 ```php
 class User
 {
@@ -411,9 +436,11 @@ echo $User->Aliases['js1']->name); // 'John Smith'
 ```
 
 #### Map
+
 Call a function for that value.
 
 Note: This does not work with arrays.
+
 ```php
 class User
 {
@@ -571,4 +598,66 @@ class User
      ])]
     public string $url;
 }
-```
+```
+
+## Local Development
+
+This project provides a convenient [dock](https://github.com/zero-to-prod/dock) script to simplify local development workflows within Docker
+containers.
+
+You can use this script to initialize the project, manage Composer dependencies, and run tests in a consistent PHP environment.
+
+### Prerequisites
+
+- Docker installed and running
+- A `.env` file (created automatically via the `dock init`z command, if it doesn’t already exist)
+
+### Initializing
+
+Use the following commands to set up the project:
+
+```shell
+sh dock init
+sh dock composer update
+```
+
+### Testing
+
+This command runs PHPUnit inside the Docker container, using the PHP version specified in your `.env` file.
+You can modify or extend this script to include additional tests or commands as needed.
+
+```shell
+sh dock test
+```
+
+Run the test suite with all versions of php:
+
+```shell
+sh test.sh
+```
+
+### Configuration
+
+Before starting development, verify that your `.env` file contains the correct settings.
+
+You can specify which PHP version to use for local development, debugging, and Composer operations by updating these variables in your `.env` file:
+
+```dotenv
+PHP_VERSION=8.1
+PHP_DEBUG=8.1
+PHP_COMPOSER=8.1
+```
+
+Make sure these values reflect the PHP versions you intend to use.
+If the `.env` file does not exist, run the `sh dock init` command to create one from the `.env.example` template.
+
+## Contributing
+
+Contributions, issues, and feature requests are welcome!
+Feel free to check the [issues](https://github.com/zero-to-prod/data-model-helper/issues) page if you want to contribute.
+
+1. Fork the repository.
+2. Create a new branch (`git checkout -b feature-branch`).
+3. Commit changes (`git commit -m 'Add some feature'`).
+4. Push to the branch (`git push origin feature-branch`).
+5. Create a new Pull Request.