We've merged#19807 and now the/controller page shows the nice#[MapUploadedFile] attribute.

This new feature is fantastic ... but I wonder if it's a good idea to show it in/controller.

This is one of the most critical chapters of Symfony Docs and part of the "Getting Started" series. So, I think that showing this could be a bit overwhelming for readers, mostly newcomers.

Also, we have this page too, which now looks weird and outdated:https://symfony.com/doc/current/controller/upload_file.html

So, this is what I propose:

• Updatecontroller/upload_file.rst entirely:
  • Show the#[MapUploadedFile] attribute first
  • Think if we should still show the previous way. If yes, let's do it at the bottom of the article and more concisely
• Remove the#[MapUploadedFile] docs fromcontroller.rst and only keep a tip mentioning it and linking to the doc about file uploads
• These changes should only be made on 7.1 branch

What do you think?