devdocs icon indicating copy to clipboard operation
devdocs copied to clipboard

Make docroot pub requirement more prominent in install documentation

Open bernieu2 opened this issue 3 years ago • 2 comments

Make docroot pub requirement more prominent in install documentation

Topic Link

Possible areas to add warnings https://devdocs.magento.com/guides/v2.4/install-gde/prereq/prereq-overview.html https://devdocs.magento.com/guides/v2.4/install-gde/composer.html https://devdocs.magento.com/guides/v2.4/install-gde/install/cli/install-cli-install.html https://devdocs.magento.com/guides/v2.4/install-gde/install/verify.html

Description

The install docs do not have any information requiring webserver root to be set to the /pub/ directory at any time prior to installation. Seeing a large amount of confusion on forums and stackexchange filling up with users unaware of this when they are installing Magento for the first time or upgrading to 2.4.2. Please consider updating the install docs so that this is emphasised earlier in the install process.

Possible solutions

Include prominent link or warning box to emphasise that the application should be served from /pub/ and include link to tutorial https://devdocs.magento.com/guides/v2.3/install-gde/tutorials/change-docroot-to-pub.html

bernieu2 avatar Mar 31 '21 02:03 bernieu2

Hey @shrielenee this looks like it might be related to some of the work you're doing to update the install guide.

erikmarr avatar Mar 31 '21 14:03 erikmarr

Thanks @erikmarr ! Add this to our "to-do" list!

shrielenee avatar Mar 31 '21 15:03 shrielenee