Evaluator Guide

The PHP 8.1.6 requirement has been added earlier. I just added a sentence about what to do if PHP is missing.

I agree that maybe the standard profile is a better demo, simpler, but I think that decision should be done in a separate issue - if you still care.

Thanks for reporting this @rovo. We could include a link to this page: https://formulae.brew.sh/formula/php

Maybe you can check if that would fix the challenge for MacOS users, and the quick-start command works after that?

I do think Umami profile is best used here as a showcase, demoing what Drupal is capable of with multilingual, search, default content, etc.

I added the link to the PHP installation manual (which contains MacOS specific instructions - that uses Homebrew) to avoid adding links to solutions for specific operating systems. If we start doing that, this is no longer a quick / short guide.

I see that you have added instructions for MacOS and one family of Linux. What about all the other Linux distros that don't use Apt? What about Windows? I hope we can agree on just point to the PHP manual which has sections for each OS. (If that manual isn't good enough we should work to improve that. At least in a perfect world.)

I did it like that because ~80% of users in the "2023 Drupal Local Development Survey" use MacOS or Debian-based Linux. If we want to guide MacOS users to Homebrew anyway, I think we should link there directly, since that is much quicker.

... nearly 56% of users on Macs [...] Debian-based Linux is overwhelmingly the most popular Linux distro family. (24%)

From https://www.ironstar.io/devsurvey23/#operating-system-usage

It's a good point about Windows and other Linux distros, I have added a note about that, with the link to PHP page.

I object :-) He-he. I'm not going to argue further, but I'm going to repeat my standard point of view: In the Drupal documentation, we should focus on documenting Drupal specifics. (I'll not list the pros - and cons - of this approach now.)

Thanks for letting this one slip and (pragmatically) allow new users to try Drupal much faster :-)
But I do agree that we shouldn't get too OS specific, as a rule of thumb.

Thanks @ressa and @hansfn for all your efforts. This page reads better, especially with the CODE blocks.

An aside, I wonder why the URL page name has a leading underscore.
https://www.drupal.org/docs/official_docs/en/ → _evaluator_guide.html

These pages was treated specially earlier so I assume the underscore tried to tell that. We could remove it now :-)

Automatically closed - issue fixed for 2 weeks with no activity.