Hi, for some modules, "experimental" might be fine, but I believe calling QRhi or QPA experimental might send the wrong message: It's not an experiment that, if successful, would at some point become stable API, but it's API where we never want commit to API and ABI stability, as we need the flexibility to adapt to changes in the underlying APIs. "experimental" might also be read as "not fit for production usage", which is IMHO also the wrong message.
Kind regards, Fabian -- Fabian Kosmale Manager The Qt Company GmbH Erich-Thilo-Str. 10 D-12489 Berlin [email protected] +49 1638686070 http://qt.io Geschäftsführer: Mika Pälsi, Juha Varelius, Juha Puputti Sitz der Gesellschaft: Berlin Registergericht: Amtsgericht Charlottenburg, HRB 144331 B -- ________________________________________ Von: Development <[email protected]> im Auftrag von Artem Dyomin via Development <[email protected]> Gesendet: Donnerstag, 21. Mai 2026 11:07 An: Qt development mailing list Betreff: [Development] Semi-private headers in Qt In Qt, we have semi-private functionality for rhi, qpa, ssg, that contain a disclaimer in headers and docs limiting SC and BC guarantees, and requiring to link the private part of the module. The headers are deployed as <QtGui/rhi/qrhi.h> etc. We want to add similar headers for Multimedia with GStreamer functionality. A good idea is having a good name for this kind of API (e.g. experimental) and deploy the headers as <QtModule/experimental/qheader.h>. The current plan is deploying new gstreamer-related headers under the new name, and then consider transferring existing headers to the new approach (with keeping old ones). In my view, the term "experimental" is the best as the term "experimental" in C++ highly correlates with how Qt declares it in terms of SC and BC. A discussion has been started in the CR adding "experimental". https://codereview.qt-project.org/c/qt/qtbase/+/736307 Other proposals are "semiprivate", "nocompat", "unstable" or similar. Are you agreed that <QtModule/experimental/qheader.h> works fine for these semi-private headers? Confidential -- Development mailing list [email protected] https://lists.qt-project.org/listinfo/development
