symfony / symfony-docs

The Symfony documentation
https://symfony.com/doc
Other
2.15k stars 5.1k forks source link

Remove "Using Symfony with Homestead" from the docs, add "Using Symfony with Herd" #20068

Open mpathy opened 1 month ago

mpathy commented 1 month ago

Description

As I work regularly with Laravel as well as Symfony, I found out that in the documentation, still the old workflow is propagated: https://symfony.com/doc/current/setup/homestead.html

But Laravel now has deprecated this workflow, because there are faster development options now, with Laravel Herd and Laravel Sail.

Laravel Herd has Symfony support out of the box, and it is blazing fast, with Symfony even faster than Laravel of course. Perfect for any web developer who wants something that "just works", even on Windows, without need to learn all the docker/vagrant/devops magic. One-Click-Install. You can add every service/database/etc. you will use on the production machine by just a click, not even editing files is needed.

https://herd.laravel.com/ https://laravel.com/docs/11.x/installation#local-installation-using-herd

javiereguiluz commented 1 month ago

@mpathy thanks a lot for creating this issue and explaining the situation.

In newer articles we avoid adding instructions about technologies that are controlled by us or we don't know well and use a lot. This article is a bit old, so we were more permissive then and added lots of docs about external tools.

So, in #20072, I propose to delete the Homestead/Vagrant entirely. Instead of creating a new article about Laravel Herd (an external tool that we don't know or use) I propose to add a short mention to it in the main setup article (and also mention Homestead/Vagrant explicitly as a legacy solution) so this is less confusing to folks that end up there after a redirect from the deleted Homestead/Vagrant page.

mpathy commented 1 month ago

Okay, that makes sense. And yes, including a link to the Laravel Herd website should be sufficient.

But it really is worth changing because it really is the easiest way to set up a development enviroment for Symfony, Slim, Laravel and so on. (Supported Frameworks: https://herd.laravel.com/docs/windows/1/extending-herd/supported-frameworks)

For a beginner in Symfony, often on a Windows machine, who just wants to learn Symfony, and not how to deploy it (for now) this is really the easiest way possible. Because just want to learn Symfony, and not all the knowledge you have to learn to host something or install services, or Linux, or use Docker for example.

I dont expect other changes in that regard. That is the one-click solution which was the result of the experience with the earlier tools.

(For more experienced users, they already have their setup or are comfortable using docker - and for them, there is already your own docker image, and a doc page for it)