I can't remember if we reached any conclusion for how to handle the images, diagrams, and illustrations in the specification document.
Currently, there is a pull request for replacing the PNGs with SVGs  that needs some feedback.
Does this conversion step help now? Or should we move directly to a text-based format to generate the diagrams from the Asciidoc to make editing easier? Something like AsciiDoctor Diagram ?
Jakarta EE Developer Advocate | Eclipse Foundation
Eclipse Foundation - Community. Code. Collaboration.