Skip to content

Commit

Permalink
DOCS: 4x updates to the general doc (helidon-io#7673)
Browse files Browse the repository at this point in the history
* updates to the general doc

* updates for 4x migrations
  • Loading branch information
ljamen authored and dalexandrov committed Oct 17, 2023
1 parent 2d9a900 commit 93cfc36
Show file tree
Hide file tree
Showing 4 changed files with 26 additions and 13 deletions.
19 changes: 15 additions & 4 deletions docs/about/doc_overview.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ include::{rootdir}/includes/attributes.adoc[]
.Introduction to Helidon
[icon=lightbulb]
--
New to Helidon? Start here to learn how Helidon's open-source set of Java libraries can help you write cloud-native Java microservices.
Start here to learn how Helidon's open-source set of Java libraries can help you write cloud-native Java microservices.
xref:{rootdir}/about/introduction.adoc[What is Helidon?]
Expand Down Expand Up @@ -106,12 +106,16 @@ xref:{rootdir}/se/guides/overview.adoc[SE Guides]
xref:{rootdir}/mp/guides/overview.adoc[MP Guides]
--
//Advanced Features
//Advanced SE Features
[CARD]
.Advanced Features
.Advanced SE Features
[icon=hotel_class]
--
xref:{rootdir}/se/webserver.adoc[Helidon WebServer]
xref:{rootdir}/se/metrics/metrics.adoc[Helidon Metrics]
xref:{rootdir}/se/config/introduction.adoc[Helidon Config]
--
Expand All @@ -120,11 +124,18 @@ xref:{rootdir}/mp/guides/overview.adoc[MP Guides]
.Training and Certification
[icon=model_training]
--
Learn:
Training:
https://learn.oracle.com/ols/learning-path/become-a-helidon-microservices-developer-professional/88258/114512[Become a Helidon Microservices Developer Professional]
Certification:
https://learn.oracle.com/ols/learning-path/become-a-helidon-microservices-developer-professional/88258/114512[Helidon Microservices Developer Professional (1Z0-1113)]
New to Helidon? Check out https://a.co/d/0niQnwC[Beginning Helidon] to learn more about building cloud-native microservices with Helidon.
--
//Get Involved
Expand Down
6 changes: 3 additions & 3 deletions docs/about/intro.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -27,12 +27,12 @@
* Introduction of the new Helidon WebServer (Project Níma): a virtual threads-based web server implementation based on https://openjdk.org/jeps/444[JDK Project Loom] virtual threads.
* Removed Helidon's Reactive WebServer and WebClient that were based on Netty. Our new implementations are based on virtual threads that have a blocking style API (Helidon N&iacute;ma). Learn more: <<Helidon 4 WebServer, Helidon 4 WebServer.>>
* Removed Helidon's Reactive WebServer and WebClient that were based on Netty. Our new implementations are based on virtual threads that have a blocking style API (Project N&iacute;ma). Learn more: <<Helidon 4 WebServer, Helidon 4 WebServer.>>
* Converted other _reactive_ API modules to _blocking_ style APIs. The `io.helidon.common.reactive` APIs will stay as general purpose reactive utilities and operators. Learn more: <<Helidon SE, Helidon SE>>
* Upgraded MicroProfile support to MicroProfile 6 and Jakarta 10 Core Profile running on the Helidon N&iacute;ma WebServer. Learn more: <<Helidon MP, Helidon MP>>
* Upgraded MicroProfile support to MicroProfile 6 and Jakarta 10 Core Profile running on the Helidon WebServer. Learn more: <<Helidon MP, Helidon MP>>
* Java 21 is required to use Helidon 4.
Expand Down Expand Up @@ -68,7 +68,7 @@ doSomething(request.content().as(JsonObject.class), response);
== Helidon MP
Helidon MP is Helidon's MicroProfile implementation and in Helidon 4 it supports MicroProfile 6 and the Jakarta EE 10 Core Profile. Your Helidon 3 MicroProfile application should migrate to Helidon 4 fairly easily (the most significant changes are in MicroProfile Metrics 5.0), and since Helidon's MicroProfile server is based on the new Helidon N&iacute;ma WebServer, you get all the benefits of running on virtual threads.
Helidon MP is Helidon's MicroProfile implementation and in Helidon 4 it supports MicroProfile 6 and the Jakarta EE 10 Core Profile. Your Helidon 3 MicroProfile application should migrate to Helidon 4 fairly easily (the most significant changes are in MicroProfile Metrics 5.0), and since Helidon's MicroProfile server is based on the new Helidon WebServer (Project N&iacute;ma), you get all the benefits of running on virtual threads.
Expand Down
12 changes: 7 additions & 5 deletions docs/about/introduction.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ Helidon comes in two flavors: *Helidon SE* and *Helidon MP*. Think about these f
|Microframework model with a very small footprint and limited functionality (~7 MB).
| https://projects.eclipse.org/proposals/eclipse-microprofile[MicroProfile] implementation; slightly larger footprint than SE (~13 MB).
|Helidon SE is Helidon’s foundational set of APIs. Virtual threads have enabled these APIs to change from asynchronous to blocking. This results in much simpler code that is easier to write, maintain, debug and understand..
|Helidon SE is Helidon’s foundational set of APIs. As of Helidon 4, virtual threads have enabled these APIs to change from asynchronous to blocking. This results in much simpler code that is easier to write, maintain, debug and understand..
|Declarative style with dependency injection.
|Transparent "no magic" development experience; pure java application development with no annotations and no dependency injections.
Expand Down Expand Up @@ -129,20 +129,22 @@ We also strongly suggest installing the xref:cli.adoc[Helidon CLI] (command line
== Migration
In case you need to upgrade the version of Helidon, follow the `Migration Guides`.
To upgrade your current version of Helidon, follow the `Migration Guides`:
For migration from Helidon 3.x to 4.x:
To migrate from from Helidon 3.x to 4.x:
//Mitia to create these guides for 4x
* xref:{rootdir}/se/guides/migration_4x.adoc[Helidon SE 4x Migration Guide]
* xref:{rootdir}/mp/guides/migration_4x.adoc[Helidon MP 4x Migration Guide]
For migration from Helidon 2.x to 3.x:
To migrate from Helidon 2.x to 3.x:
* xref:{rootdir}/se/guides/migration_3x.adoc[Helidon SE 3x Migration Guide]
* xref:{rootdir}/mp/guides/migration_3x.adoc[Helidon MP 3x Migration Guide]
For migration from Helidon 1.x to 2.x:
To migrate from Helidon 1.x to 2.x:
* xref:{rootdir}/se/guides/migration.adoc[Helidon SE 2x Migration Guide]
* xref:{rootdir}/mp/guides/migration.adoc[Helidon MP 2x Migration Guide]
Expand Down
2 changes: 1 addition & 1 deletion docs/se/introduction.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -160,7 +160,7 @@ Enables Java applications to participate in WebSocket interactions as both serve
== Migration
In case you need to upgrade the version of Helidon, follow the `upgrade guides`.
Use the Helidon migration guides to upgrade your current version of Helidon.
[PILLARS]
====
Expand Down

0 comments on commit 93cfc36

Please sign in to comment.