docs(app): Additional docs fixes

Author: lonnieezell

user_guide_src/source/outgoing/api_transformers.rst

@@ -19,15 +19,15 @@ Quick Example
 
 The following example shows a common usage pattern for transformers in your application.
 
-.. literalinclude:: api_resources/001.php
+.. literalinclude:: api_transformers/001.php
 
 In this example, the ``UserTransformer`` defines which fields from a user entity should be included in the
 API response. The ``transform()`` method converts a single resource, while ``transformMany()`` handles
 collections of resources.
 
-******************
+**********************
 Creating a Transformer
-******************
+**********************
 
 To create a transformer, extend the ``BaseTransformer`` class and implement the ``toArray()`` method to
 define your API resource structure. The ``toArray()`` method receives the resource being transformed as
@@ -36,7 +36,7 @@ a parameter, allowing you to access and transform its data.
 Basic Transformer
 =================
 
-.. literalinclude:: api_resources/002.php
+.. literalinclude:: api_transformers/002.php
 
 The ``toArray()`` method receives the resource (entity, array, or object) as its parameter and defines
 the structure of your API response. You can include any fields you want from the resource, and you can
@@ -98,7 +98,7 @@ Using Transformers in Controllers
 Once you've created a transformer, you can use it in your controllers to transform data before returning
 it to the client.
 
-.. literalinclude:: api_resources/003.php
+.. literalinclude:: api_transformers/003.php
 
 ***********************
 Field Filtering
@@ -107,7 +107,7 @@ Field Filtering
 The transformer automatically supports field filtering through the ``fields`` query parameter of the current URL.
 This allows API clients to request only specific fields they need, reducing bandwidth and improving performance.
 
-.. literalinclude:: api_resources/007.php
+.. literalinclude:: api_transformers/007.php
 
 A request to ``/users/1?fields=id,name`` would return only:
 
@@ -124,14 +124,14 @@ Restricting Available Fields
 By default, clients can request any field defined in your ``toArray()`` method. You can restrict which
 fields are allowed by overriding the ``getAllowedFields()`` method:
 
-.. literalinclude:: api_resources/008.php
+.. literalinclude:: api_transformers/008.php
 
 Now, even if a client requests ``/users/1?fields=email``, an ``ApiException`` will be thrown because
 ``email`` is not in the allowed fields list.
 
-***********************
+***************************
 Including Related Resources
-***********************
+***************************
 
 Transformers support loading of related resources through the ``include`` query parameter. This
 follows a common API pattern where clients can specify which relationships they want included.
@@ -145,7 +145,7 @@ To support including related resources, create methods prefixed with ``include``
 resource name. Inside these methods, you can access the current resource being transformed via
 ``$this->resource``:
 
-.. literalinclude:: api_resources/009.php
+.. literalinclude:: api_transformers/009.php
 
 Note how the include methods use ``$this->resource['id']`` to access the ID of the user being transformed.
 The ``$this->resource`` property is automatically set by the transformer when ``transform()`` is called.
@@ -180,11 +180,11 @@ Restricting Available Includes
 Similar to field filtering, you can restrict which relationships can be included by overriding the
 ``getAllowedIncludes()`` method:
 
-.. literalinclude:: api_resources/010.php
+.. literalinclude:: api_transformers/010.php
 
 If you want to disable all includes, return an empty array:
 
-.. literalinclude:: api_resources/011.php
+.. literalinclude:: api_transformers/011.php
 
 Include Validation
 ==================
@@ -202,20 +202,20 @@ And your transformer doesn't have an ``includeInvalid()`` method, an exception w
 
 This helps catch typos and prevents unexpected behavior.
 
-***********************
+************************
 Transforming Collections
-***********************
+************************
 
 The ``transformMany()`` method makes it easy to transform arrays of resources:
 
-.. literalinclude:: api_resources/012.php
+.. literalinclude:: api_transformers/012.php
 
 The ``transformMany()`` method applies the same transformation logic to each item in the collection,
 including any field filtering or includes specified in the request.
 
-***********************
+*********************************
 Working with Different Data Types
-***********************
+*********************************
 
 Transformers can handle various data types, not just entities.
 
@@ -225,28 +225,28 @@ Transforming Entities
 When you pass an ``Entity`` instance to ``transform()``, it automatically calls the entity's ``toArray()``
 method to get the data:
 
-.. literalinclude:: api_resources/013.php
+.. literalinclude:: api_transformers/013.php
 
 Transforming Arrays
 ===================
 
 You can transform plain arrays as well:
 
-.. literalinclude:: api_resources/014.php
+.. literalinclude:: api_transformers/014.php
 
 Transforming Objects
 ====================
 
 Any object can be cast to an array and transformed:
 
-.. literalinclude:: api_resources/015.php
+.. literalinclude:: api_transformers/015.php
 
 Using toArray() Only
 ====================
 
 If you don't pass a resource to ``transform()``, it will use the data from your ``toArray()`` method:
 
-.. literalinclude:: api_resources/016.php
+.. literalinclude:: api_transformers/016.php
 
 ***************
 Class Reference
@@ -272,7 +272,7 @@ Class Reference
         The resource parameter contains the data being transformed. Return an array with the fields you want
         to include in the API response, accessing data from the ``$resource`` parameter.
 
-        .. literalinclude:: api_resources/017.php
+        .. literalinclude:: api_transformers/017.php
 
     .. php:method:: transform($resource = null)
 
@@ -288,7 +288,7 @@ Class Reference
 
         The method automatically applies field filtering and includes based on query parameters.
 
-        .. literalinclude:: api_resources/018.php
+        .. literalinclude:: api_transformers/018.php
 
     .. php:method:: transformMany(array $resources)
 
@@ -299,7 +299,7 @@ Class Reference
         Transforms a collection of resources by calling ``transform()`` on each item. Field filtering and
         includes are applied consistently to all items.
 
-        .. literalinclude:: api_resources/019.php
+        .. literalinclude:: api_transformers/019.php
 
     .. php:method:: getAllowedFields()
 
@@ -310,7 +310,7 @@ Class Reference
         Return ``null`` (the default) to allow all fields from ``toArray()``. Return an array of field names
         to create a whitelist of allowed fields.
 
-        .. literalinclude:: api_resources/022.php
+        .. literalinclude:: api_transformers/022.php
 
     .. php:method:: getAllowedIncludes()
 
@@ -321,7 +321,7 @@ Class Reference
         parameter. Return ``null`` (the default) to allow all includes that have corresponding methods.
         Return an array of include names to create a whitelist. Return an empty array to disable all includes.
 
-        .. literalinclude:: api_resources/023.php
+        .. literalinclude:: api_transformers/023.php
 
 *******************
 Exception Reference