From 93cfc36eb7ff51281383ecc4ddfbb2756c5924c4 Mon Sep 17 00:00:00 2001 From: Lisa Jamen <31409174+ljamen@users.noreply.github.com> Date: Wed, 4 Oct 2023 10:52:02 -0400 Subject: [PATCH] DOCS: 4x updates to the general doc (#7673) * updates to the general doc * updates for 4x migrations --- docs/about/doc_overview.adoc | 19 +++++++++++++++---- docs/about/intro.adoc | 6 +++--- docs/about/introduction.adoc | 12 +++++++----- docs/se/introduction.adoc | 2 +- 4 files changed, 26 insertions(+), 13 deletions(-) diff --git a/docs/about/doc_overview.adoc b/docs/about/doc_overview.adoc index d4b6b3d68a1..ee72be68864 100644 --- a/docs/about/doc_overview.adoc +++ b/docs/about/doc_overview.adoc @@ -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?] @@ -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] -- @@ -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 diff --git a/docs/about/intro.adoc b/docs/about/intro.adoc index 539fca2588d..92316b0b158 100644 --- a/docs/about/intro.adoc +++ b/docs/about/intro.adoc @@ -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íma). Learn more: <> +* 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íma). Learn more: <> * 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: <> -* Upgraded MicroProfile support to MicroProfile 6 and Jakarta 10 Core Profile running on the Helidon Níma WebServer. Learn more: <> +* Upgraded MicroProfile support to MicroProfile 6 and Jakarta 10 Core Profile running on the Helidon WebServer. Learn more: <> * Java 21 is required to use Helidon 4. @@ -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í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íma), you get all the benefits of running on virtual threads. diff --git a/docs/about/introduction.adoc b/docs/about/introduction.adoc index d2d99646c1f..66cc0f473dc 100644 --- a/docs/about/introduction.adoc +++ b/docs/about/introduction.adoc @@ -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. @@ -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] diff --git a/docs/se/introduction.adoc b/docs/se/introduction.adoc index 63022e0e296..4529c99cb46 100644 --- a/docs/se/introduction.adoc +++ b/docs/se/introduction.adoc @@ -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] ====