We made several changes to the TypoScript reference and documentation for the topic TypoScript in general.
- Renamed to “TypoScript Templating Reference”
- Menu was restructured
- Consolidated older versions (finalized migration, …)
- Added introduction, links to other information and quick links to start page
In more detail:
Menu before and after restructuring
- It was pointed out that the “TypoScript Reference” menu was confusing in parts: some functions (such as calc and objectSplit) were found under “Objects and Properties”, top-level objects were hidden in a rubric “setup” etc. This resulted in things not being found where they were expected. We managed to simplify the menu and sort the topics accordingly.
- The use of objects and object types was used inconsistently, some types were referred to as “objects” and vice versa. Especially, the term “cObject” was used inconsistently, sometimes to refer to the type, sometimes as synonym for “content objects”. We corrected the use of these terms in some places and added a glossary.
- We renamed “TypoScript Reference” to “TypoScript Templating Reference” because the term TypoScript has 2 meanings and in this reference we mean TypoScript templating and not (primarily) TypoScript syntax (which is handled in TypoScript Syntax in “TYPO3 Explained”. See decisions.typo3.org for dicussion about this topic.
- The chapter “Introduction” contained no introduction into the topic - this is a common problem in the documentation: There is a chapter “Introduction” where you expect to find information about the topic or what the manual is about and often this only contains very little information about the manual, credits, how to give feedback etc. For this reason we renamed the current Introduction to “About this manual”, moved it to the end of the menu and added a real Introduction.
- We linked to other manuals where topics are handled in depth (TypoScript in 45 minutes and “TypoScript syntax” in “TYPO3 Explained”), both on the start page and in the “Introduction”
- We added the chapter “Using and setting TypoScript” to the older versions <= 8.7. Previously it only existed for versions 9.5 and master (10). (This is due to the fact that the migration of some manuals - like “TypoScript Syntax and in depth study” was done for version 9.5 and had not been performed for previous versions. This is now being done, step by step.)
- We added “TypoScript Syntax” to older versions <= 8.7 in “TYPO3 Explained”.
- Added quick links to start page
- The topic of using objects and objects types was addressed but could still be improved.
- Additionally, a number of pages could be improved. For example, the page FLUIDTEMPLATE could use a better introduction.
If you would like to help with this, please look at the open issues.