Skip to content

Conversation

joshtrichards
Copy link
Member

@joshtrichards joshtrichards commented Aug 30, 2025

☑️ 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

image

Previously:

image

Signed-off-by: Josh Richards <[email protected]>
@joshtrichards
Copy link
Member Author

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.

+------------------+----------+-------------+------------------+-----------------------------------------------+
| imagick | | | ✓ (optional) | Image previews |
+------------------+----------+-------------+------------------+-----------------------------------------------+
| avconv/ffmpeg | | | ✓ (optional) | Video previews |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Copy link
Contributor

@kesselb kesselb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks 👍

@come-nc
Copy link
Contributor

come-nc commented Sep 1, 2025

@joshtrichards
Copy link
Member Author

@susnux susnux merged commit 8270062 into master Sep 1, 2025
13 checks passed
@susnux susnux deleted the jtr/admin-install-php-refactor branch September 1, 2025 15:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants