devonfw / devon4j

devonfw Java stack - create enterprise-grade business apps in Java safe and fast
Apache License 2.0
83 stars 87 forks source link

modernization and alignment with devon4quarkus #420

Closed hohwille closed 2 years ago

hohwille commented 3 years ago

We are in the process to offer two general options in the Java stack of devonfw:

The current devon4j modules will remain the spring-boot specific libraries. We will fully support and maintain them also in the future. In case we will create new modules/libraries for quarkus we will create those in https://github.com/devonfw/devon4quarkus

In the documentation we have two options:

  1. Create and maintain a new and completely independet documentation for devon4quarkus and keep the devon4j documentation untouched as "devon4spring" documentation.
  2. Adopt the existing devon4j documentation as a general documentation of the Java stack in devonfw. Separate options for spring/spring-boot and quarkus where things differ.

Both options have their pros and cons. However, IMHO on the long run option 1. is better, because:

Please note that for the end-user we need a new and better way to approach the documentation anyway. A user should choose for technology such as C# or Java on our devonfw.com website. When Java is selected we should give a brief introduction about the two options spring and quarkus with some pros and cons. From these two options you should be guided to the details via simple link to some nice summary guides explaining spring-boot and quarkus approach in Java stack of devonfw.

Therefore I create this issue to link first PRs in extending the devon4j documentation accordingly.

For the record: We can still have two separate PDFs generated for spring (classic devon4j) and quarkus (devon4quarkus) if we want (even when going for option 1.).

hohwille commented 3 years ago

auto-closed by PR #421 but still not complete.

hohwille commented 3 years ago

We also need to align the logging guide. There is no reason why we have an additional guide for quarkus that is 99% not quarkus specific:

IMHO we need a facelift and alignment of the devon4j guide getting rid of the log files explanation moving to a cloud-native approach where apps just output JSON log to standard out what is already established in classic devon4j since > 1 year. Then we can move the guide to general and delete the quarkus specific one when all is merged.

baumeister25 commented 2 years ago

Anything left to do here?

hohwille commented 2 years ago

Closing as all is done.