#78 Initial draft of updated preface and intro. Removed images that a…

…re no longer used.
jakartaee · Nov 21, 2023 · 6618766 · 6618766
1 parent cfb33ad
commit 6618766
Show file tree

Hide file tree

Showing 48 changed files with 467 additions and 8,245 deletions.
diff --git a/src/main/antora/modules/ROOT/nav.adoc b/src/main/antora/modules/ROOT/nav.adoc
@@ -1,7 +1,7 @@
 
 .Introduction
 
-* xref:index.adoc[]
+* xref:preface.adoc[]
 
 * xref:intro:overview/overview.adoc[]
 

diff --git a/src/main/antora/modules/ROOT/pages/preface.adoc b/src/main/antora/modules/ROOT/pages/preface.adoc
@@ -2,6 +2,8 @@
 
 = Preface
 
+include::ROOT:partial$draft.adoc[]
+
 == Legal
 
 This documentation and the accompanying materials are made available under the terms of the Eclipse Public License v. 2.0,
@@ -14,7 +16,7 @@ Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other
 == About this Tutorial
 
 This tutorial explains how to use the features of the Jakarta EE Platform to build cloud-native applications,
-such as services (microservices or "right sized" services) and server-based web applications.
+such as microservices, "right sized" services, and server-based web applications.
 
 == Prerequisites
 
@@ -39,7 +41,7 @@ Throughout this tutorial, we use the following typographic conventions:
 
 |*Boldface* |Boldface type indicates graphical user interface elements associated with an action or terms defined in text. |From the *File* menu, choose *Open Project*.
 
-A *cache* is a copy that is stored locally.
+A *cache* is a copy stored locally.
 
 |`Monospace` |Monospace type indicates the names of files and directories, commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter. |Edit your `.login` file.
 
@@ -63,7 +65,7 @@ used in this book.
 |===
 |Placeholder |Description |Default Value
 
-|`_as-install_` |Represents the base installation directory for GlassFish Server. | Installations on the Solaris operating system, Linux operating system, and Mac operating system:
+|`_as-install_` |Represents the base installation directory for GlassFish Server. | Installations on the Linux, UNIX, or macOS:
 
 `_user's-home-directory_/glassfish6/glassfish`
 

diff --git a/src/main/antora/modules/ROOT/partials/draft.adoc b/src/main/antora/modules/ROOT/partials/draft.adoc
@@ -0,0 +1,4 @@
+[NOTE]
+====
+This section is currently a draft, and is subject to change.
+====
diff --git a/src/main/antora/modules/common/images/Figure_1_1.vsd b/src/main/antora/modules/common/images/Figure_1_1.vsd
diff --git a/src/main/antora/modules/common/images/Figure_1_2.vsd b/src/main/antora/modules/common/images/Figure_1_2.vsd
diff --git a/src/main/antora/modules/common/images/Figure_1_3.vsd b/src/main/antora/modules/common/images/Figure_1_3.vsd
diff --git a/src/main/antora/modules/common/images/Figure_1_4.vsd b/src/main/antora/modules/common/images/Figure_1_4.vsd
diff --git a/src/main/antora/modules/common/images/Figure_1_5.vsd b/src/main/antora/modules/common/images/Figure_1_5.vsd
diff --git a/src/main/antora/modules/common/images/Figure_1_6.vsd b/src/main/antora/modules/common/images/Figure_1_6.vsd
diff --git a/src/main/antora/modules/common/images/Figure_1_7.vsd b/src/main/antora/modules/common/images/Figure_1_7.vsd
diff --git a/src/main/antora/modules/common/images/Figure_1_8.vsd b/src/main/antora/modules/common/images/Figure_1_8.vsd
diff --git a/src/main/antora/modules/common/images/Figure_1_9.vsd b/src/main/antora/modules/common/images/Figure_1_9.vsd
diff --git a/src/main/antora/modules/common/images/jakartaeett_dt_001.svg b/src/main/antora/modules/common/images/jakartaeett_dt_001.svg
diff --git a/src/main/antora/modules/common/images/jakartaeett_dt_002.svg b/src/main/antora/modules/common/images/jakartaeett_dt_002.svg
diff --git a/src/main/antora/modules/common/images/jakartaeett_dt_003.svg b/src/main/antora/modules/common/images/jakartaeett_dt_003.svg
diff --git a/src/main/antora/modules/common/images/jakartaeett_dt_004.svg b/src/main/antora/modules/common/images/jakartaeett_dt_004.svg
diff --git a/src/main/antora/modules/common/images/jakartaeett_dt_005.svg b/src/main/antora/modules/common/images/jakartaeett_dt_005.svg
diff --git a/src/main/antora/modules/common/images/jakartaeett_dt_006.svg b/src/main/antora/modules/common/images/jakartaeett_dt_006.svg