Update docs

Signed-off-by: Felipe Sayão Lobato Abreu <github@mentordosnerds.com>

Author: coisa

docs/examples/basic.rst

@@ -3,7 +3,7 @@ Basic Usage
 ===========
 
 Registering and Fetching Services
-=================================
+---------------------------------
 
 This example shows how to register and retrieve services using the container helper.
 
@@ -22,7 +22,7 @@ This example shows how to register and retrieve services using the container hel
    $pdo = $container->get('pdo');
 
 Using Configuration to Register Providers
-========================================
+-----------------------------------------
 
 You can use a configuration object to register providers dynamically:
 
@@ -44,7 +44,7 @@ You can use a configuration object to register providers dynamically:
    $cache = $container->get('cache');
 
 Autowiring a Service (using PHP-DI)
-===================================
+-----------------------------------
 
 The container supports autowiring for classes with type-hinted dependencies:
 

docs/examples/factories.rst

@@ -3,7 +3,7 @@ Using Factories
 ===============
 
 Using CallableFactory for Dependency Injection
-==============================================
+----------------------------------------------
 
 .. code-block:: php
 
@@ -13,7 +13,7 @@ Using CallableFactory for Dependency Injection
    $mailer = $factory($container);
 
 Aliasing Services with AliasFactory
-==================================
+-----------------------------------
 
 .. code-block:: php
 
@@ -23,7 +23,7 @@ Aliasing Services with AliasFactory
    $sameMailer = $factory($container); // Returns the same as $container->get('mailer')
 
 Invoking Classes with InvokableFactory
-=====================================
+--------------------------------------
 
 .. code-block:: php
 
@@ -33,7 +33,7 @@ Invoking Classes with InvokableFactory
    $service = $factory($container);
 
 Calling Static Methods with MethodFactory
-========================================
+-----------------------------------------
 
 .. code-block:: php
 
@@ -43,7 +43,7 @@ Calling Static Methods with MethodFactory
    $service = $factory($container);
 
 Wrapping Existing Instances with ServiceFactory
-==============================================
+-----------------------------------------------
 
 .. code-block:: php
 

docs/examples/index.rst

@@ -6,4 +6,6 @@ Examples
 
    basic
    providers
+   providers-testing
+   providers-feature-toggle
    factories

docs/examples/providers-feature-toggle.rst

@@ -0,0 +1,19 @@
+Runtime Feature Toggle
+=====================
+
+This example demonstrates how to use providers to enable or disable features at runtime.
+
+.. code-block:: php
+
+   use FastForward\Container\ServiceProvider\ArrayServiceProvider;
+   use FastForward\Container\container;
+
+   $featureEnabled = true;
+
+   $provider = new ArrayServiceProvider([
+       'feature' => fn() => $featureEnabled ? new RealFeature() : new NullFeature(),
+   ]);
+
+   $container = container($provider);
+   $feature = $container->get('feature');
+   $feature->run();

docs/examples/providers-testing.rst

@@ -0,0 +1,21 @@
+Testing with Providers
+====================
+
+This example shows how to use providers to swap implementations for testing.
+
+.. code-block:: php
+
+   use FastForward\Container\ServiceProvider\ArrayServiceProvider;
+   use FastForward\Container\container;
+
+   class DummyMailer {
+       public function send($to, $msg) { /* test logic */ }
+   }
+
+   $testProvider = new ArrayServiceProvider([
+       'mailer' => fn() => new DummyMailer(),
+   ]);
+
+   $container = container($testProvider);
+   $mailer = $container->get('mailer');
+   $mailer->send('test@example.com', 'Hello!');

docs/examples/providers.rst

@@ -2,7 +2,7 @@ Registering Providers
 =====================
 
 Registering Multiple Providers
-=============================
+------------------------------
 
 .. code-block:: php
 
@@ -22,7 +22,7 @@ Registering Multiple Providers
    $notifier = $container->get('notifier');
 
 Extending Services with Providers
-=================================
+---------------------------------
 
 .. code-block:: php
 
@@ -47,7 +47,7 @@ Extending Services with Providers
    $repo = $container->get('user_repo');
 
 Composing Providers for Feature Modules
-======================================
+---------------------------------------
 
 .. code-block:: php
 
@@ -70,7 +70,7 @@ Composing Providers for Feature Modules
 
 
 Using Providers with Config
-==========================
+---------------------------
 
 .. code-block:: php
 
@@ -94,7 +94,7 @@ Using Providers with Config
 
 
 Provider Returning a Factory
-===========================
+----------------------------
 
 .. code-block:: php
 
@@ -111,7 +111,7 @@ Provider Returning a Factory
 
 
 Provider with Extension for Caching
-==================================
+-----------------------------------
 
 .. code-block:: php