get.typo3.org icon indicating copy to clipboard operation
get.typo3.org copied to clipboard

Confusing system requirements details (circural references)

Open tmotyl opened this issue 1 year ago • 2 comments

for detailed server requirements to install TYPO3, the get.typo3.org is redirecting users to getting started tutorial. Getting started tutorial is redirecting users back to get.typo3.org

Steps:

  1. Go to https://get.typo3.org/version/13#system-requirements
  2. You want to learn more, e.g. what php modules are required, so you follow the link "For more information and installation instructions read the Installation guide."
  3. Then you end up on the page https://docs.typo3.org/m/typo3/tutorial-getting-started/main/en-us/Installation/SystemRequirements/Index.html
  4. Which redirects you back to get.typo3.org "You will need a webserver, an up-to-date version of PHP and an SQL database. See here which versions of TYPO3 are current and their requirements get.typo3.org."

And actually the most useful information are on https://docs.typo3.org/m/typo3/reference-coreapi/13.4/en-us/Administration/Installation/SystemRequirements/Index.html (this is the only page which mentions php modules and imagemagic).

Btw, the https://github.com/TYPO3/typo3/blob/main/INSTALL.md file points to https://docs.typo3.org/system-requirements which redirects to https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/Administration/Installation/SystemRequirements/Index.html But this page doesn't mention the servers/php versions.

tmotyl avatar Dec 20 '24 15:12 tmotyl

The main version of the system requirements article and the version 13.4 seem to contain the same content?

Getting started itself cannot repeat all the requirements it gets updated to seldom and would be perpetually outdated. Things like required PHP and MySQL versions are listed on get.typo3.org. If you need to install additional PHP versions that is an advanced topic and out of scope for a gettings started tutorial

linawolf avatar Dec 21 '24 11:12 linawolf

IMHO https://github.com/TYPO3-Documentation/TYPO3CMS-Tutorial-GettingStarted/pull/656 will fix it by linking to TYPO3 Explained https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/Administration/Installation/SystemRequirements/Index.html

jonaseberle avatar Jan 09 '25 11:01 jonaseberle