Since 8.7 (I think), we got 2 new tutorials roughly about the same time:
- “Sitepackage Tutorial” by Michael Schams: https://docs.typo3.org/m/typo3/tutorial-sitepackage/master/en-us/
- "Templating Tutorial (with FLUIDTEMPLATE) by Andrew Murphy: https://docs.typo3.org/m/typo3/tutorial-templating/master/en-us/
The “Templating Tutorial” got merged into the older already existing repository for the marker based tutorials which are still available in the older branches.
They cover very similar topics - templating in TYPO3 with FLUIDTEMPLATE. Very roughly, I would say the “Sitepackage” covers the TYPO3 best practice way using a Sitepackage. The “Templating tutorial” has examples with templates in fileadmin (which is actually no longer considered best practice).
On the pro side of the “Templating Tutorial” I find it an easier read. It simplifies things in a nice way, while the “Sitepackage Tutorial” felt a little overwhelming.
If we look at the defintion of Tutorials (e.g in a text by Daniele Procida) they are “learning oriented” and must not necessarily follow best practices by the letter. But putting templates in fileadmin just feels wrong to me (actually I never really understood why this was done in the first place, why in this directory).
Opinions about this?
My goal is to make a decision: Do we need and want 2 tutorials? How do we describe them on the “Tutorials and Guides” page? Can we seamlessly walk a beginner through the wild and wonderful world of TYPO3?