Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DOCS: 4x updates to the general doc #7673

Merged
merged 2 commits into from
Oct 4, 2023
Merged

DOCS: 4x updates to the general doc #7673

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
baf405f
updates to the general doc
ljamen Sep 26, 2023
caf9dba
updates for 4x migrations
ljamen Sep 28, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 15 additions & 4 deletions docs/about/doc_overview.adoc
View file
Open in desktop
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 @@ -110,12 +110,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 @@ -124,11 +128,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)]

ljamen marked this conversation as resolved.
Show resolved Hide resolved
New to Helidon? Check out https://a.co/d/0niQnwC[Beginning Helidon] to learn more about building cloud-native microservices with Helidon.
ljamen marked this conversation as resolved.
Show resolved Hide resolved



--

//Get Involved
Expand Down
6 changes: 3 additions & 3 deletions docs/about/intro.adoc
View file
Open in desktop
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.>>
dalexandrov marked this conversation as resolved.
Show resolved Hide resolved


* 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 Heldon 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.
dalexandrov marked this conversation as resolved.
Show resolved Hide resolved



Expand Down
6 changes: 4 additions & 2 deletions docs/about/introduction.adoc
View file
Open in desktop
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,10 +129,12 @@ 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:

//Mitia to create these guides for 4x

* link to SE 4x migration guide [tbd]
* link to MP 4x migration guide [tbd]

Expand Down