These docs are inconsistent, out of date, and extremely frustrating.

On hour 5 of attempting to perform a manual install of Akeneo to evaluate it for our business.

Following https://docs.akeneo.com/master/install_pim/manual/system_requirements/manual_system_installation_debian11.html

I have encountered dozens of showstopping errors, following this guide to the letter.

PHP installation fails - and requires multiple manual workarounds, not mentioned at all. It is not clear what version of Debian 11 we are supposed to be using, because the final build 11.8 does not work as described.

There is no guidance to user account setup, and the provided guidance for setting user accounts for php-fpm doesn't work. There is no mention of composer being required until it is used - and no guidance for installation of one of the most critical components to installing akeneo.

If you do not have unzip installed on the system, the composer create project will fail with obscure errors. Again, unzip is not a listed dependency. If you do not have make installed on the system, composer will fail. Again, make is not a listed dependency.

The .env file description in https://docs.akeneo.com/master/install_pim/manual/installation_ce.html#initializing-akeneo is completely confusing. Editing the .env file directly causes it to be overwitten during make.

You need to COPY the .env file into .env.local - this is not described anywhere.

Finally the make file runs and then errors with more cryptic error codes with no documentation or explanation.

make[2]: * [Makefile:56: database] Error 255 make[2]: Leaving directory '//pim-community-standard' make[1]: [Makefile:93: pim-prod] Error 2 make[1]: Leaving directory '/*/pim-community-standard' make: *** [Makefile:79: prod] Error 2

This has been a frustrating and extremely poor first time experience with your platform.

akeneo / pim-docs

These docs are inconsistent, out of date, and extremely frustrating. #1878