Project

General

Profile

Task #88018

Updated by Sybille Peters almost 5 years ago

Changelogs are really useful and often provide the best description of new features. But the information is quite fragmented and I think it would be useful, if we add more links to main documentation and possibly move some of the information from the changelog to the main documentation.  

 I'd like to do the following: 

 * Add links to main documentation 
 * Add links to related Changelog 
 * -in some cases, move information from Changelog to main documentation- 

 I am following the following concepts / best practices: 

 * Do not use absolute URLs, use intersphinx linking mechanism (`:ref:`) 
 * -defragment- 
 * -deduplicate- 
 * if possible, have one main entry point for a topic 
 * use links 
 * direct people to main source of documentation. For core information, this is usually "TYPO3 Explained" or one of the references. 

 Related (in docs): 

 * "How to deal with Changelog becoming main documentation for some new features":https://github.com/TYPO3-Documentation/TYPO3CMS-Reference-CoreApi/issues/418 
 * see also several issues on structure in project "Content structure":https://github.com/orgs/TYPO3-Documentation/projects/6 

 Possible candidates: 

 * "Important: #82692 - Guidelines for ext_localconf.php and ext_tables.php":https://docs.typo3.org/typo3cms/extensions/core/latest/Changelog/9.0/Important-82692-GuidelinesForExtensionFiles.html could link to "TYPO3 Explained":https://docs.typo3.org/typo3cms/CoreApiReference/latest/ExtensionArchitecture/ConfigurationFiles/Index.html 

Back