Skip to main content
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [jakarta.ee-community] Looking for help with recreating editable images
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

Back to the top