The new version of Content Translation has the goal to provide better guidance to newcomers. In many cases this involves providing brief information in the user interface with a link to learn more that is expected to point to help documentation for the topic.
In order to properly support this, there is a need to update, and reorganize the end-user documentation of Content Translation. Actions to take place are listed below:
Establish a central entry point for documentation
The central entry point for help will be at https://www.mediawiki.org/wiki/Help:Content_translation
We need to review other pages in order to move contents from different locations used in the past:
- https://www.mediawiki.org/wiki/Help:Extension:ContentTranslation (note the "Extension:" part of the URL)
- Some sub-pages of https://www.mediawiki.org/wiki/Content_translation/Product_Definition
Update contents
We want to focus the documentation on the new version (version 2) in order to avoid the need for future updates once it becomes the default version. Some notes can be added to mark functionality as not available in version 1, to avoid confusion. We need to update the links in the source code that point to pages that are moved (e.g., T131655) or when specific ones are created.
Topics to cover (as specific sub-pages):
- Unmodified automatic translation prevention. Related to T190279, T190798, T190283 (more comments on T201525#4538071)
- Template adaptation and its limitations. Related to T192271
- (more to be added)