docs(file-upload): move from core to symfony and update

Author: vinceAmstoutz

admin/file-upload.md

@@ -1,6 +1,6 @@
 # Handling File Upload
 
-If you need to handle the file upload in the server part, please follow [the related documentation](../core/file-upload.md).
+If you need to handle the file upload in the server part, please follow [the related documentation](../symfony/file-upload.md).
 
 This documentation assumes you have a `/media_objects` endpoint accepting `multipart/form-data`-encoded data.
 

core/graphql.md

@@ -19,7 +19,8 @@ composer require api-platform/graphql
 You can now use GraphQL at the endpoint: `https://localhost:8443/graphql`.
 
 > [!NOTE]
-> If you used [the Symfony Variant thanks to Symfony Flex](../symfony/index.md#using-symfony-flex-and-composer-advanced-users) or the Laravel variant, URLs will be prefixed with `/api` by default. For example, the GraphQL endpoint will be: `https://localhost:8443/api/graphql`.
+> If you used [the Symfony Variant thanks to Symfony Flex](../symfony/index.md#installing-the-framework) or the Laravel
+> variant, URLs will be prefixed with `/api` by default. For example, the GraphQL endpoint will be: `https://localhost:8443/api/graphql`.
 
 ## Changing Location of the GraphQL Endpoint
 
@@ -138,7 +139,7 @@ api_platform:
 ### Disable GraphQL Playground with Laravel
 
 > [!WARNING]
-> This is not yet available with Laravel, you're welcome to contribute [on Github](github.com/api-platform/core)
+> This is not yet available with Laravel, you're welcome to contribute [on GitHub](https://github.com/api-platform/core)
 
 ### Add another Location for GraphQL Playground
 
@@ -1100,7 +1101,7 @@ resources:
 
 ### Syntax for Filters with a List of Key / Value Arguments
 
-Some filters like the [exists filter](filters.md#exists-filter) or the [order filter](filters.md#order-filter-sorting) take a list of key / value as arguments.
+Some filters like the [exists filter](doctrine-filters.md#exists-filter) or the [order filter](doctrine-filters.md#order-filter-sorting) take a list of key / value as arguments.
 
 The first syntax coming to mind to use them is to write:
 
@@ -1387,7 +1388,7 @@ resources:
 
 </code-selector>
 
-Once enabled, a `page` filter will be available in the collection query (its name [can be changed in the configuration](pagination.md)) and an `itemsPerPage` filter will be available too if [client-side-pagination](pagination.md#client-side) is enabled.
+Once enabled, a `page` filter will be available in the collection query (its name [can be changed in the configuration](pagination.md)) and an `itemsPerPage` filter will be available too if [client-side-pagination](pagination.md#disabling-the-pagination-client-side) is enabled.
 
 A `paginationInfo` field can be queried to obtain the following information:
 
@@ -2812,7 +2813,7 @@ final class BookContextBuilder implements SerializerContextBuilderInterface
 ## Export the Schema in SDL
 
 > [!WARNING]
-> This command is not yet available with Laravel, you're welcome to contribute [on Github](github.com/api-platform/core)
+> This command is not yet available with Laravel, you're welcome to contribute [on GitHub](https://github.com/api-platform/core)
 
 You may need to export your schema in SDL (Schema Definition Language) to import it in some tools.
 
@@ -2828,9 +2829,10 @@ Since the command prints the schema to the output if you don't use the `-o` opti
     bin/console api:graphql:export > path/in/host/schema.graphql
 ```
 
-## Handling File Upload
+## Handling File Upload with Symfony
 
-Please follow the [file upload documentation](file-upload.md), only the differences will be documented here.
+If you use Symfony, please follow the [file upload documentation](../symfony/file-upload.md), only the differences
+will be documented here.
 
 The file upload with GraphQL follows the [GraphQL multipart request specification](https://github.com/jaydenseric/graphql-multipart-request-spec).
 

outline.yaml

@@ -9,6 +9,7 @@ chapters:
       - testing
       - debugging
       - caddy
+      - file-upload
   - title: "API Platform for Laravel"
     path: laravel
     items:
@@ -59,7 +60,6 @@ chapters:
       - elasticsearch
       - controllers
       - events
-      - file-upload
       - jwt
       - user
       - form-data

core/file-upload.md renamed to symfony/file-upload.md

@@ -1,15 +1,14 @@
-# Handling File Upload
-
-As common a problem as it may seem, handling file upload requires a custom
-implementation in your app. This page will guide you in handling file upload in
-your API, with the help of
-[VichUploaderBundle](https://github.com/dustin10/VichUploaderBundle). It is
-recommended you [read the documentation of
-VichUploaderBundle](https://github.com/dustin10/VichUploaderBundle/blob/master/docs/index.md)
+# Handling File Upload with Symfony
+
+As common a problem as it may seem, handling file upload requires a custom implementation in your app. This page will
+guide you in handling file upload in your API, with the help of[VichUploaderBundle](https://github.com/dustin10/VichUploaderBundle).
+It is recommended you [read the documentation of VichUploaderBundle](https://github.com/dustin10/VichUploaderBundle/blob/master/docs/index.md)
 before proceeding. It will help you get a grasp on how the bundle works, and why we use it.
 
-**Note**: Uploading files won't work in `PUT` or `PATCH` requests, you must use `POST` method to upload files.
-See [the related issue on Symfony](https://github.com/symfony/symfony/issues/9226) and [the related bug in PHP](https://bugs.php.net/bug.php?id=55815) talking about this behavior.
+> [!NOTE]
+> Uploading files won't work in `PUT` or `PATCH` requests, you must use `POST` method to upload files.
+> See [the related issue on Symfony](https://github.com/symfony/symfony/issues/9226) and
+> [the related bug in PHP](https://bugs.php.net/bug.php?id=55815) talking about this behavior.
 
 Enable the multipart format globally in order to use it as the input format of your resource:
 
@@ -137,7 +136,7 @@ Note: From V3.3 onwards, `'multipart/form-data'` must either be including in the
 Returning the plain file path on the filesystem where the file is stored is not useful for the client, which needs a
 URL to work with.
 
-A [normalizer](serialization.md#normalization) could be used to set the `contentUrl` property:
+A [normalizer](../core/serialization.md#normalization) could be used to set the `contentUrl` property:
 
 ```php
 <?php