Current Situation: collect.kde.org
KDevelop currently still uses collect.kde.org as online service for the custom download of developer documentation files in QCH format. The idea had been that the list of documentation files would be curated. As a matter of fact, after a short while the list was no longer maintained and stayed that way for many years since then. So the plan has not worked out.
KDevelop is the last one using collect.kde.org, so the service can e shut down once KDevelop no longer uses it. The other previous user, Kate, now ships the formerly hosted curated syntax definition files directly (actually the KSyntaxHighlighting liibrary does now). Given the sizes of QCH files, direct shipping of curated files as part of the software is not an option there.
So it might make sense to just switch to "community curated" list of files using store.kde.org.
Possible Future Situation: store.kde.org
Question to store.kde.org managers:
does store.kde.org support the concept of indirect links to products, where the actual content file is on another service? Or would one have to upload the actual QCH file to store.kde.org? I see there is an option for "Add URL" on the pling.com product editing page, but I never used that, so have no idea how that works.
The synchrotron-software run collect,kde.org has in the desktop file such an entry to forward;
X-Synchrotron-ContentUrl=http://www.grantlee.org/grantlee-020.qch
Which category to use:
While currently only KDevelop would use this category, QCH files are consumable also by other applications, like Qt Assistant, Qt Creator or other potential documentation readers (I have some WIP documentation reader locally). And ideally all developer documentation readers would share the collection of QCH files installed from store.kde.org.
So I would prefer if the the category name would not be KDevelop specific
Perhaps
Categories=API Documentation QCH Files
(other proposals welcome)
Currently served QCH files
The few currently listed documentation can be seen here:
https://cgit.kde.org/synchrotron-sources.git/tree/kdevelop-qthelp
- cppreference (outdated version, actually also available as normal package in Arch, Debian, Ubuntu: https://en.cppreference.com/w/Cppreference:Archives)
- grantlee (outdated version 0.2)
- kdelibs (no longer interesting)
- kdepimlibs (outdated version 4.x)
- kf5 (outdated link, also packaged if KF5 is built with BUILD_QCH=ON)
- qwt (outdated version)
- stl (outdated link)