Re: [jakarta.ee-community] Looking for help with recreating editable ima

["Kevin Sutter" <sutter@xxxxxxxxxx>]

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



From:
       Edwin
Derks <ederks85@xxxxxxxxx>
To:
       Jakarta
EE community discussions <jakarta.ee-community@xxxxxxxxxxx>
Date:
       06/17/2020
13:23
Subject:
       [EXTERNAL]
Re: [jakarta.ee-community] Looking for help with recreating    
   editable images
Sent
by:        jakarta.ee-community-bounces@xxxxxxxxxxx

---

Hi all,

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?

Edwin

On Wed, 17 Jun 2020 at 19:45, Kevin Sutter
<sutter@xxxxxxxxxx>
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. 
Thanks!

---------------------------------------------------
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



From:        "Torkild
U. Resheim" <torkildr@xxxxxxxxx>
To:        Jakarta
EE community discussions <jakarta.ee-community@xxxxxxxxxxx>
Cc:        jakartaee-platform
developer discussions <jakartaee-platform-dev@xxxxxxxxxxx>
Date:        06/17/2020
11:34
Subject:        [EXTERNAL]
Re: [jakarta.ee-community] Looking for help with recreating editable images
Sent by:        jakarta.ee-community-bounces@xxxxxxxxxxx

---

Hi,

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[1]. There are also
excellent tools and editor support in various IDEs. Did you look into that?

Best regards,
Torkild

[1] https://github.com/plantuml/plantuml

> 17. jun. 2020 kl. 18:22 skrev Kevin Sutter <sutter@xxxxxxxxxx>:
> 
> Hi,
> Throwing the net a bit wide on this one to see if we have any "artists"
in our midst... We have a couple of diagrams in the Platform Spec that
need to be updated for Jakarta EE 9.  They are currently in png format,
which makes them very difficult to edit.  As an experiment, we recreated
the two diagrams that were part of the Deployment chapter using inkscape
(https://inkscape.org/)
and creating svg format.  It took a little bit of work to recreate
these diagrams, but now they are very easy to edit for future endeavors.
 Here they are...
> 
> https://github.com/eclipse-ee4j/jakartaee-platform/blob/master/specification/src/main/asciidoc/images/deploy.svg
> https://github.com/eclipse-ee4j/jakartaee-platform/blob/master/specification/src/main/asciidoc/images/deployment-schema.svg
> 
> I've created the following Issue for this effort:  https://github.com/eclipse-ee4j/jakartaee-platform/issues/214.
 We have two images that absolutely need to get updated, the rest
of them are not required for Jakarta EE 9 and can stay in png format.
> 
> https://github.com/eclipse-ee4j/jakartaee-platform/blob/master/specification/src/main/asciidoc/images/JavaEEarchitecture.png
> https://github.com/eclipse-ee4j/jakartaee-platform/blob/master/specification/src/main/asciidoc/images/JavaEEinteroperability.png
> 
> If any of you have an interest in helping out, just sign up by commenting
on the Issue or letting me know directly.  We need to use open-source
tools, so please don't suggest using some proprietary, off-the-shelf graphic
editing software.  We experimented with several alternatives and inkscape
seemed to be an excellent alternative.  If somebody has other alternatives,
I'm open to other suggestions.  Simple is better...  Thanks!
> 
> ---------------------------------------------------
> 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
> _______________________________________________
> jakarta.ee-community mailing list
> jakarta.ee-community@xxxxxxxxxxx
> To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/jakarta.ee-community

[attachment "signature.asc" deleted by Kevin Sutter/Rochester/IBM]
_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/jakarta.ee-community



_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/jakarta.ee-community_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/jakarta.ee-community