2024-09-23 –, Hall C+D
QEMU: Let's talk about QMP, QAPI, and our user-facing API documentation generated by Sphinx.
-
Have you ever wondered what the difference between QMP and QAPI is, and have a deep-seated fear that not knowing the precise, technical answer will come to haunt you in five years when your new feature ships in an enterprise distribution?
-
Have you ever laid awake in bed at night wondering what exactly that new enum value you added actually changed in the QMP protocol, if anything?
-
Have you ever logged in to develop a new QEMU feature on Monday morning while slightly hung over and cursed out the QMP reference manual and/or your god(s) in a fit of rage while exclaiming "Someone ought to fix this!"?
It's me! I'm "Someone"! Come and see what we are cooking up, this talk is for you.
Recent developments in the QAPI generator and what this means for developers implementing new APIs and features are covered, as well as the new massive QMP user documentation overhaul project that will -- this time, we promise -- produce user-friendly, reliable, accurate, and aesthetically pleasing QMP documentation that will serve as our new gold standard that will help direct users of QMP and libvirt users alike.
Pleas of help for QEMU maintainers with relevant subject expertise to review/refresh QMP documentation will also feature prominently.
jsnow is perhaps best known for signing off emails with "--js" despite not really knowing how to write javascript beyond the superficial details. They have been with Red Hat and working on QEMU for over ten years, somehow.