Documentation of custom suites

[ayacoo]

I played around a bit with this repository and created my own suite. With it I can test my projects + their extensions well.

I admit that the whole thing is not that simple and was implemented with local means, but whoever creates a fork of this repo can version that well.

Is there interest in expanding the documentation to this end? I could first describe here in the ticket in bullet points what I have done.

Anyway. Thanks for all the work here :-) This will certainly help us very well in the creation of manuals!

[linawolf]

Quite cool, that you are working on this! I think @alexander-nitsche has plans on further facilitating the creation of additional suites. That is why we have not documented the current process yet. But I would love to hear about your experiences and maybe even see the results?

[ayacoo]

This is my local changelist:

• ddev: Append new domain via additional_hostnames (config.suites.yaml)
• ddev: Add webimage_extra_packages rst2pdf. It's just for my case, but I find it exciting and maybe something for later.
• root composer.json - Add my local extension as skeleton via custom repo ("path") Based on t3doc-examples, but later there was actually only the database available as XML
• The database (data.xml) is a simple case. Just a startpage and a text element
• Add custom folder in ./suites. Just the dist.json with my extension and the res/AdditionalConfiguration.php with my custom hostname
• In screenshots Extension: Add Runner Class with ProjectCest.php File, based on examples. Just changed the classs name and the suite reference -> packages/screenshots/Classes/Runer/Project/ProjectCest.php
• In screenshots Extension: Add suite for codeception, based on examples -> packages/screenshots/Classes/Runner/codeception.yml
• In screenshots Extension: Add an environment in packages/screenshots/Classes/Runner/Codeception/Support/Extension/ProjectEnvironment.php Change "testExtensionsToLoad" and $extensionKey

After these steps, I was able to install my suite and also successfully take screenshots with it. I'd be happy to go through the whole procedure again, clean it up and fork the changes.

IMPORTANT: outline that this project starts for TYPO3 v11 and backport to v10 is not planned.

[ayacoo]

Update is here :-)