Remove GIMP History Appendix from docs (and migrate its content to gimp-web)
[I'd potentially work on this task, however first need to make sure there's some rough consensus.]
The GIMP user help unfortunately has a section in the Appendix called "GIMP History".
- It makes the help even bigger.
- It creates more work for translators with questionable gain.
- It is entirely off-topic (as a user, I go to the help to find out how to perform a certain task in the software application and not to found out how developers spent their time 30 years ago or which version many years ago received which changes - I am using the current version and I expect the user help to cover the current version and not to be a collection of ancient release notes).
Even worse, the GIMP History pages include random images which follow no naming scheme so images cannot be recognized as "historical". This creates problems:
- You may consider screenshots embedded in GIMP History pages historical artefacts not to be changed, however at least two of them are also embedded into other "real" help pages and thus are or have been subject to change. This destroys the concept of History if you display a most recent depiction instead of what was originally there.
- As a translator, seeing only images themselves to be potentially localized, without knowing that they are "only" embedded in the History Appendix and nowhere else in the user help, it is impossible to tell which images to attempt to localize or not. It's wasting time of volunteer efforts. Neither the image file name nor the image file path provide any hint that these historical images should not be attempted to be localized.
- As a documentation writer, looking at GIMP's images by traversing through the source code tree, I cannot recognize if an image which may need updating is used in actual help pages or in a History page (and thus does not need updating).
Please ideally remove the "GIMP History" appendix and host it outside of the user help. Because it is no help, by definition.
Assuming this might be too controversial, please at least
- rename (file naming style with prefix) and ideally relocate (some "archive" path?) images only used in the History appendix so translators have a slightly bigger chance to realize that they shall not waste time trying to translate these screenshots,
- do not use images embedded in History pages also in other places (two such cases listed below) ever. Split them; potentially restore the original revision to be used in History pages.
Images used also in places outside of GIMP History appendix pages (and thus now potentially displaying incorrect "too modern" content in History pages):
./appendix/history-26.xml: fileref="images/using/new-free-select-tool.png"/>
./toolbox/selection/free.xml: fileref="images/using/new-free-select-tool.png"/>
./appendix/history-26.xml: fileref="images/using/empty-image-window.png"/>
./using/getting-unstuck-gui.xml: fileref="images/using/empty-image-window.png"/>
Images only used in GIMP History appendix pages:
./appendix/history-28.xml: fileref="images/using/experimental-gegl-tool.png"/>
./appendix/history-28.xml: fileref="images/using/math-size-entries.png"/>
./appendix/history-28.xml: fileref="images/using/image-lock-pixels.png"/>
./appendix/history-28.xml: fileref="images/using/new-cage-tool.png"/>
./appendix/history-28.xml: fileref="images/using/improved-text-tool.png"/>
./appendix/history-28.xml: fileref="images/using/image-layer-groups.png"/>
./appendix/history-28.xml: fileref="images/using/rotating-brushes.png"/>
./appendix/history-28.xml: fileref="images/using/cairo-progress-indicator.png"/>
./appendix/history-28.xml: fileref="images/using/single-window-mode.png"/>
./appendix/history-28.xml: fileref="images/using/save-image-overwrite.png"/>
./appendix/history-28.xml: fileref="images/using/multiple-image-tabs.png"/>
./appendix/history-28.xml: fileref="images/using/multi-column-docks.png"/>
./appendix/history-28.xml: fileref="images/using/painting-resources-tags.png"/>
./appendix/history-26.xml: fileref="images/using/experimental-gegl-tool.png"/>
./appendix/history-26.xml: fileref="images/using/scroll-beyond-border.png"/>
./appendix/history-26.xml: fileref="images/using/brush-dynamics.jpg"/>
./appendix/history-26.xml: fileref="images/using/text-tool.png"/>
./appendix/history-26.xml: fileref="images/using/rectangle-handles.png"/>
./appendix/history-26.xml: fileref="images/using/gimp-curves-tool-2-4-vs-2-6.png"/>
./appendix/history-24.xml: fileref="images/using/24-selection-tools.png"/>
./appendix/history-24.xml: fileref="images/using/24-scalable-brushes.png"/>
./appendix/history-24.xml: fileref="images/using/24-color-management.png"/>