minor cleanup

Author: ljonesfl

.version.json

@@ -0,0 +1,7 @@
+{
+  "strategy": "semver",
+  "major": 0,
+  "minor": 7,
+  "patch": 1,
+  "build": 0
+}

README.md

@@ -1,4 +1,4 @@
-[![Build Status](https://app.travis-ci.com/Neuron-PHP/formatting.svg?token=F8zCwpT7x7Res7J2N4vF&branch=master)](https://app.travis-ci.com/Neuron-PHP/formatting)
+[![CI](https://github.com/Neuron-PHP/formatting/actions/workflows/ci.yml/badge.svg)](https://github.com/Neuron-PHP/formatting/actions)
 
 # Neuron-PHP Formatting
 

src/Formatters/IFormatter.php

@@ -3,9 +3,40 @@
 namespace Neuron\Formatters;
 
 /**
- * Formatter interface.
+ * Formatter interface for data transformation and display formatting.
+ * 
+ * This interface defines the contract for all formatters in the Neuron framework.
+ * Formatters are responsible for converting raw data into human-readable or 
+ * standardized formats. They provide a consistent way to transform data for
+ * display, export, or standardization purposes.
+ * 
+ * Common formatter implementations include:
+ * - Currency formatting with locale-specific symbols and precision
+ * - Date/time formatting with various display patterns
+ * - Phone number formatting with regional standards
+ * - Address formatting according to postal standards
+ * 
+ * @package Neuron\Formatters
+ * 
+ * @example
+ * ```php
+ * class CurrencyFormatter implements IFormatter
+ * {
+ *     public function format(string $data): ?string
+ *     {
+ *         $amount = floatval($data);
+ *         return '$' . number_format($amount, 2);
+ *     }
+ * }
+ * ```
  */
 interface IFormatter
 {
+	/**
+	 * Formats the provided data according to the formatter's rules.
+	 * 
+	 * @param string $Data The raw data to be formatted
+	 * @return string|null The formatted data, or null if formatting fails
+	 */
 	public function format( string $Data ) : ?string;
 }