On 6/11/26 22:01, Pierrick Bouvier wrote:
On 11/6/2026 12:36 PM, Alex Bennée wrote:
Pierrick Bouvier <[email protected]> writes:
On 11/6/2026 4:21 AM, Alex Bennée wrote:
We've had various versions of this diagram for a while so I thought it
would be worth adding to the developer docs. I chose plantuml as it
has a plugin for sphinx that we can use and supports sequence diagrams
which could be useful for documenting other features in the code base.
Signed-off-by: Alex Bennée <[email protected]>
---
vRFC
- I've bundled all the plumbing together in this commit but it can
be split up if we want to go forward.
---
docs/conf.py | 22 +++++++++++++++
docs/devel/index-process.rst | 47 +++++++++++++++++++++++++++++++++
docs/meson.build | 3 ++-
docs/requirements.txt | 1 +
configure | 6 +++++
pythondeps.toml | 1 +
tests/lcitool/mappings.yml | 3 +++
tests/lcitool/projects/qemu.yml | 1 +
8 files changed, 83 insertions(+), 1 deletion(-)
I have the ascii original although ditaa seemed more of a stretch:
--8<---------------cut here---------------start------------->8---
#+name: QEMU Development Process
#+begin_src ditaa :cmdline -T -o :file images/qemu-dev-process.png
Developer QEMU Community
Subsystem Maintainer
+-=--------------------------+
+-=---------------------------------------------------+
+-=----------------------+
| | |
| | |
| +-------------------+ | |
+-----------------------------------------------+ | | +----------------+
|
| |{io} | | | |{io}
| | | |{io} | |
| | Develop and | | +--->| Code Review on List
| | +---->| Add Maintainer | |
| | Test feature | | | | |
| | | | | Sign-off | |
| | | | | |
+------+----------------+----------------+------+ | | | | |
|
| +--------+----------+ | | | | |
| | | | +-------+--------+ |
| | | | | V V
V | | | | |
| V | | : +-------------+ +-------------+
+-------------+ | | | v |
| +-------------------+ | | | |{d} | |{d} | |{io}
| | | | +----------------+ |
| |{io} | | | | | Review | | Review | |
Maintainer | | | | |{s} | |
| +->| Post to List +-----+ | | Comments | | Tags | |
accepts | | | | | GIT Branch | |
| | | | | | | | | | | some
or all | | | | | foo/next | |
| | +-------------------+ | | | | | | |
patches | | | | | | |
| | : | +------+------+ +------+------+
+------+------+ | | : | | |
| | +-------------------+ | | | |
| | | | | | |
| | |{io} |<----------------+ |
+-----------+ | | | |
| | | Incorporate | |
| | | | |
| | | Feedback |<---------------------------------+
| | | | |
| | +--------+----------+ | |
: | +-------+--------+ |
| | | :
+-----------------------------------------------------+ | |
|
| | v |
| V |
| | +-------------------+ | QEMU Maintainer
| +----------------+ |
| | |{io} | |
+-=-----------------------------------------------------+ | |{io}
| |
| | | Prepare n+1 | | | +-------------+ +--------------+
+----------------+ | | | Sign & Submit | |
| | | | | | |{io} | |{s} | |{io}
| | | | Pull | |
| | +--------+----------+ | | | Tag Release |<-+ qemu.git |<-+ Test and
Merge |<-------+ Request | |
| | | | | | | | master | | Pull
Reqs |<-+ | | | |
| +-----------+ | | | | | | |
| || | +----------------+ |
| | | +------+------+ +--------------+
+----------------+ || | |
+----------------------------+
+--------+----------------------------------------------+|
+------------------------+
+----------------+
|
|
|
V
| Pull Requests
+--------------+
+---- from
|{d} |
Other Maintainers
| QEMU |
| Release |
| |
| |
+--------------+
#+end_src
--8<---------------cut here---------------end--------------->8---
Nice diagram!
Better in picture indeed.
In the picture can we express the time dilatation factor in the
arrows to help contributors understand when they shouldn't worry
wrt QEMU mailing list pace? Like the wider the arrow the more we
need to wait.