refactor(admin): Improve the PHP Modules & Configuration chapter

[joshtrichards]

☑️ Resolves

The current chapter covering how to prepare PHP for a new Nextcloud Server installation is fairly comprehensive, but I felt could benefit from some polishing.

Improved by (among other things):

• organizing the steps more logically
• making it clearer which PHP modules are required, recommended, optional, or only situational
• reducing repetition
• adding additional context (i.e. why modules/settings are needed, links to relevant configuration chapters, friendlier introduction)
• adjusting the chapter title

I think the chapter's clarity has improved. And the new headings also make it easier to link to specific scenarios.

P.S. While doing this I noted that there was initially a commit in #12871 that elaborated on gmp for WebAuthn but it got chopped during a merge of master back into that PR. Was that intentional or an accident? Cc: @susnux & @rakekniven

🖼️ Screenshots

New

Previously:

[joshtrichards]

Aside: I tapped GitHub Copilot to suggest an initial improvement baseline for rewriting this section. I was able to turn around a nice prototype in seconds. I disagreed with some of the changes so it took a couple more hours to make things how I wanted (through good old-fashioned manual editing). Based on this experiment, Copilot (or other similar AI agents) can be a helpful tool for refactoring our documentation.

[kesselb]

This is a bit misleading, as avconf/ffmpeg/libreoffice are no PHP modules.

[joshtrichards]

agreed, but that's somewhat of a problem already on this page as-is. ;-) I'm thinking of adding a "Preparing your Server" (or similar) chapter as part of a broader reorg of the entire Installation/Deployment section. Those might better belong somewhere like that.

[kesselb]

Thanks 👍

[come-nc]

@joshtrichards I’m afraid this might break https://github.com/nextcloud/documentation/blob/f8048dafcba898cbbc973966b61657378ba5d08e/go.php#L38C1-L39C1 ?

[joshtrichards]

I’m afraid this might break https://github.com/nextcloud/documentation/blob/f8048dafcba898cbbc973966b61657378ba5d08e/go.php#L38C1-L39C1 ?

@come-nc Good catch. Fixed.