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.

Reply via email to