helidon-io · ljamen · Feb 28, 2023 · Feb 27, 2023 · Feb 27, 2023 · Feb 27, 2023
diff --git a/docs/about/additional_info.adoc b/docs/about/additional_info.adoc
@@ -0,0 +1,20 @@
+///////////////////////////////////////////////////////////////////////////////
+
+    Copyright (c) 2023 Oracle and/or its affiliates.
+
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+///////////////////////////////////////////////////////////////////////////////
+
+= Learn More About Helidon
+
diff --git a/docs/about/benefits.adoc b/docs/about/benefits.adoc
@@ -0,0 +1,19 @@
+///////////////////////////////////////////////////////////////////////////////
+
+    Copyright (c) 2023 Oracle and/or its affiliates.
+
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+///////////////////////////////////////////////////////////////////////////////
+
+= Features and Benefits of Helidon
diff --git a/docs/about/doc_overview.adoc b/docs/about/doc_overview.adoc
@@ -0,0 +1,143 @@
+///////////////////////////////////////////////////////////////////////////////
+
+    Copyright (c) 2018, 2023 Oracle and/or its affiliates.
+
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+///////////////////////////////////////////////////////////////////////////////
+
+= Documentation Overview
+:description: Helidon
+:keywords: helidon, java, microservices, microprofile
+:rootdir: {docdir}/..
+
+include::{rootdir}/includes/attributes.adoc[]
+
+This is test to see if this displays. Can we add some text about what's included in the docs?
+
+[PILLARS]
+====
+//Introduction to Helidon
+[CARD]
+.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.
+
+xref:{rootdir}/about/introduction.adoc[What is Helidon?]
+
+xref:{rootdir}/about/benefits.adoc[Features and Benefits]
+
+xref:{rootdir}/about/archetype.adoc[Helidon Archetypes]
+
+xref:{rootdir}/about/additional_info.adoc[Reference and Community Resources]
+
+xref:{rootdir}/about/intro.adoc[What's New in Helidon 4]
+
+
+--
+//Getting Started
+[CARD]
+.Getting Started
+[icon=settings]
+--
+There are several ways to generate your first Helidon project. In a hurry? The Helidon CLI and Project Starter provide a set of predefined archetypes to choose from. Or try the Quickstart guides for the standard Helidon Maven archetypes.   
+
+xref:{rootdir}/about/prerequisites.adoc[Prerequisites and System Requirements]
+
+xref:{rootdir}/about/cli.adoc[Using the Helidon CLI]
+
+xref:{rootdir}/about/generating_project.adoc[Using Project Starter]
+
+xref:{rootdir}/mp/guides/quickstart.adoc[Using the MP Quickstart Guide]
+
+xref:{rootdir}/se/guides/quickstart.adoc[Using the SE Quick Start Guide]
+
+
+--
+
+//Migration Guides
+[CARD]
+.Upgrading Helidon
+[icon=storage]
+--
+Use the migration guides to help you upgrade your existing Helidon applications to the latest version of Helidon.
+
+xref:{rootdir}/mp/guides/migration_3x.adoc[Upgrade From Helidon MP 3.x]
+
+xref:{rootdir}/mp/guides/migration.adoc[Upgrade From Helidon MP 2.x]
+
+xref:{rootdir}/se/guides/migration_3x.adoc[Upgrade From Helidon SE 3.x]
+
+xref:{rootdir}/se/guides/migration.adoc[Upgrade From Helidon SE 2.x]
+
+--
+
+
+
+//Developing Your First Application
+[CARD]
+.Developing Your First Application From Scratch
+[icon=share]
+--
+Use these hands-on development tutorials to learn how to generate a small "Hello World!" greeting service that demonstrates some of Helidon's core features. 
+
+xref:{rootdir}/mp/guides/mp-tutorial.adoc[Helidon MP Tutorial]
+
+xref:{rootdir}/mp/guides/mp-tutorial.adoc[Helidon SE Tutorial]
+
+--
+
+//How-To Guides
+[CARD]
+.How-To Guides
+[icon=graphic_eq]
+--
+Ready for more hands-on learning? Explore the features of Helidon with these quick step-by-step guides.
+
+Nima Guides
+
+xref:{rootdir}/se/guides/overview.adoc[SE Guides]
+
+xref:{rootdir}/mp/guides/overview.adoc[MP Guides]
+
+--
+//Helidon Nima
+[CARD]
+.Helidon Nima 
+[icon=swap_horiz]
+--
+
+--
+
+
+//Helidon MP
+[CARD]
+.Helidon MP
+[icon=swap_horiz]
+--
+
+--
+
+//Helidon SE
+[CARD]
+.Helidon SE
+[icon=swap_horiz]
+--
+
+--
+====
+
+
+
+
diff --git a/docs/about/generating_project.adoc b/docs/about/generating_project.adoc
@@ -0,0 +1,86 @@
+///////////////////////////////////////////////////////////////////////////////
+
+    Copyright (c) 2023 Oracle and/or its affiliates.
+
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+///////////////////////////////////////////////////////////////////////////////
+
+= Helidon Project Starter
+
+
+
+https://helidon.io/starter[Helidon Project Starter] allows you to choose from a set of archetypes with pre-defined feature sets and lets you customize it by providing a host of options.
+
+== Select a Flavor
+
+
+=== Helidon SE
+
+=== Helidon MP
+
+=== Nima
+
+
+== Choose an Application Type
+Helidon provides the following set of archetypes to bootstrap your application development journey.
+
+=== QuickStart 
+This option creates a Helidon project that includes multiple REST operations along with default observability setup and a set of dependencies to enable ease of development e.g. in case of Helidon MP, it uses `helidon-microprofile` bundle instead of minimal `helidon-microprofile-core` bundle.
+
+=== Database
+This option builds on `QuickStart` to demonstrate how to integrate with database (in-memory H2, by default). In case of, Helidon SE that uses the DbClient API while for Helidon MP that uses JPA.
+
+=== Custom
+This option enables user to create Helidon project of their choice, suitable to start from scratch i.e. bare minimum, if default values are chosen Or choose from many options available.
+
+=== OCI (MP Only)
+This option builds on `QuickStart` to demonstrate integration with Oracle Cloud Infrastructure (OCI) services using the OCI SDK. Generated project showcases OpenApi-driven development approach where the practice of designing and building APIs is done first, then creating the rest of an application around them is implemented next. This is available for Helidon MP only.
+
+
+== Media Support Options
+
+=== Jackson JSON 
+
+=== JSON-B
+Default.
+
+=== JSON-P (SE Only)
+
+== Customize Project
+
+* groupId
+* artifactId
+* Project Version
+* Java package name
+
+== Download the Project Files
+
+Click *Download* and Project Starter generates the files in a directory named after the `artifactId` value. It mainly contains the following:
+
+* Maven structure
+
+* skeletal application code
+
+* associated unit test code
+
+* example Dockerfile files
+
+* application configuration file(s)
+
+* Readme file with instructions to build and run application/test
+
+
+
+
+
diff --git a/docs/about/intro.adoc b/docs/about/intro.adoc
@@ -0,0 +1,26 @@
+///////////////////////////////////////////////////////////////////////////////
+
+    Copyright (c) 2023 Oracle and/or its affiliates.
+
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+///////////////////////////////////////////////////////////////////////////////
+
+= Introducing Helidon 4
+:description: Helidon
+:keywords: helidon, java, microservices
+:rootdir: {docdir}/..
+
+
+== What's New in This Release
+
diff --git a/docs/about/introduction.adoc b/docs/about/introduction.adoc
@@ -1,6 +1,6 @@
 ///////////////////////////////////////////////////////////////////////////////
 
-    Copyright (c) 2018, 2022 Oracle and/or its affiliates.
+    Copyright (c) 2018, 2023 Oracle and/or its affiliates.
 
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
@@ -16,14 +16,14 @@
 
 ///////////////////////////////////////////////////////////////////////////////
 
-= Introduction
+= Introducing Helidon
 :description: Helidon
 :keywords: helidon, java, microservices, microprofile
 :rootdir: {docdir}/..
 
 include::{rootdir}/includes/attributes.adoc[]
 
-== Contents
+== What is Helidon?
 
 * <<What is Helidon?, What is Helidon?>>
 * <<Helidon Flavors, Helidon Flavors>>

diff --git a/docs/config/config_reference.adoc b/docs/config/config_reference.adoc
@@ -63,6 +63,7 @@ The following section lists all configurable types in Helidon.
 - xref:{rootdir}/config/io_helidon_security_providers_oidc_common_OidcConfig.adoc[OidcConfig (security.providers.oidc.common)]
 - xref:{rootdir}/config/io_helidon_security_providers_oidc_OidcProvider.adoc[OidcProvider (security.providers.oidc)]
 - xref:{rootdir}/config/io_helidon_openapi_OpenAPISupport.adoc[OpenAPISupport (openapi)]
+- xref:{rootdir}/config/io_helidon_openapi_OpenApiUi.adoc[OpenApiUi (openapi)]
 - xref:{rootdir}/config/io_helidon_security_providers_common_OutboundConfig.adoc[OutboundConfig (security.providers.common)]
 - xref:{rootdir}/config/io_helidon_security_providers_common_OutboundTarget.adoc[OutboundTarget (security.providers.common)]
 - xref:{rootdir}/config/io_helidon_common_pki_KeyConfig_PemBuilder.adoc[PemBuilder (common.pki.KeyConfig)]

diff --git a/docs/config/io_helidon_openapi_OpenAPISupport.adoc b/docs/config/io_helidon_openapi_OpenAPISupport.adoc
@@ -1,6 +1,6 @@
 ///////////////////////////////////////////////////////////////////////////////
 
-    Copyright (c) 2022 Oracle and/or its affiliates.
+    Copyright (c) 2022, 2023 Oracle and/or its affiliates.
 
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
@@ -46,6 +46,7 @@ Type: link:{javadoc-base-url}/io.helidon.openapi/io/helidon/openapi/OpenAPISuppo
 
 |`cors` |xref:{rootdir}/config/io_helidon_reactive_webserver_cors_CrossOriginConfig.adoc[CrossOriginConfig] |{nbsp} |Assigns the CORS settings for the OpenAPI endpoint.
 |`static-file` |string |`META-INF/openapi.*` |Sets the file system path of the static OpenAPI document file. Default types are `json`, `yaml`, and `yml`.
+//|`ui` |xref:{rootdir}/config/io_helidon_openapi_OpenApiUi.adoc[OpenApiUi] |{nbsp} |Assigns the OpenAPI UI builder the `OpenAPISupport` service should use in preparing the U/I.
 |`web-context` |string |`/openapi` |Sets the web context path for the OpenAPI endpoint.
 
 |===