Hi Edwin, I don't think
we have to decide on a single type of image format or tool to be used across
all of the Specifications. Yes, it's good to have Asciidoc as a base.
But, each component Specification may have different requirements
for their images. Whatever works for each component is fine by me.
Just like with the Platform spec, the use of png images is working
just fine for almost all of the images. It's just a couple of them
that need to editable. We have found that svg is working for our
needs, but maybe that's not sufficient for some other usage. That's
my view anyway...
--------------------------------------------------- Kevin Sutter STSM, MicroProfile and Jakarta EE architect @ IBM e-mail: sutter@xxxxxxxxxx Twitter: @kwsutter phone: tl-553-3620 (office), 507-253-3620 (office) LinkedIn: https://www.linkedin.com/in/kevinwsutter
Derks <ederks85@xxxxxxxxx> To:
EE community discussions <jakarta.ee-community@xxxxxxxxxxx> Date:
Re: [jakarta.ee-community] Looking for help with recreating
editable images Sent
I was also thinking about starting to
use a format with a source that can recreate the images if necessary, such
as we use Asciidoc for generating the specification documents, for example.
I'm not sure however, if this is common practise or defined somewhere,
and applied consistently within the Jakarta EE codebase? Meaning if
we now start using PlantUML, or Draw.io or Gliffy as alternative suggestions,
to set that as a default for Jakarta EE?
On Wed, 17 Jun 2020 at 19:45, Kevin Sutter
wrote: Hi Torkild! This is not required for the Milestone, so we still have some time.
I would say beginning of August would be a best-case deadline. This
would still give us time to do more editing before we claim we're done
with the Platform spec. We did not try PlantUML. Some of our diagrams are not UML-based,
so I'm not sure if that would work or not. You are welcome to experiment
and let us know. We did try a couple of IDEs as well as Google docs.
One issue that we found is that when the diagram is exported, it's just
a bunch of bits and the diagram is not as editable as one would like.
We want an image format that can be re-opened and editable easily by open-source
tools. Proof is in the pudding, as they say. If you have thoughts
on what can work, then please experiment and let us know the results.
I wish I could offer some time, but not right now. Do you have a deadline?
My personal tool for this kind of thing is PlantUML. There are also
excellent tools and editor support in various IDEs. Did you look into that?