[BUG] Running composer docs:db fails

[stweil]

Description

Several documentation files were build using composer docs:db, but this command no longer works with the latest main branch installed on TYPO3 v11.

The command tries to execute Build/Documentation/dbdocs/generate.php which fails to find vendor/autoload.php (might require different paths for TYPO3 v11 and TYPO3 v12 or later).

[sebastian-meyer]

@thomaslow could that be a side-effect of #1337?

[thomaslow]

I'll look into it.

[sebastian-meyer]

Thank you, @thomaslow!

[thomaslow]

I investigated the compose docs:db command. It is used to generate the reStructuredText file Documentation/Developers/Database.rst, which has not been updated in the last 3 years.

I'm not sure why the code is located in the Build/Documentation/dbdocs directory. I guess the idea was that it isn't code that is needed at runtime. On the other hand, the code requires access to the database in order to extract information about the database schema.

In order to make this work, the generate.php somehow configures a custom typo3 environment based on the classic non-composer based typo3 directory structure, which is why there is a symbolic link Build/Documentation/dbdocs/public/typo3.

Anyway. My suggestion would be to move this code to the Classes/Command directory and register a new typo3 command kitodo:dbdocs that will trigger the generation process of the documentation file.

I added the pull request #1486 to demonstrate my proposal. What do you think?

[sebastian-meyer]

Yes, that seems reasonable! Thank you!