This is an automated email from the ASF dual-hosted git repository.
mariofusco pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/incubator-kie-drools.git
The following commit(s) were added to refs/heads/main by this push:
new ccd9f9f8c1 [incubator-kie-drools#5758] Update drools-docs for v10
(#5770)
ccd9f9f8c1 is described below
commit ccd9f9f8c130448946e9961e24676fa166b01734
Author: Toshiya Kobayashi <[email protected]>
AuthorDate: Fri Mar 8 18:55:47 2024 +0900
[incubator-kie-drools#5758] Update drools-docs for v10 (#5770)
---
.../_KIEBuilding-section.adoc | 2 +-
.../BuildDeployUtilizeAndRun/_rule-unit-api.adoc | 2 +-
.../BuildDeployUtilizeAndRun/_rule-unit-dsl.adoc | 2 +-
.../_artifacts/document-attributes-drools.adoc | 13 ------
.../ROOT/pages/_artifacts/document-attributes.adoc | 16 ++-----
.../pages/getting-started/_first-rule-project.adoc | 2 +-
.../ROOT/pages/language-reference/_drl-rules.adoc | 2 +-
.../_missing_features_components.adoc | 4 +-
.../migration-guide/_traditional-to-ruleunit.adoc | 12 +++--
.../pages/release-notes/_release-notes-10.0.adoc | 5 ++
.../pages/release-notes/_release-notes-8.31.adoc | 5 --
.../pages/release-notes/_release-notes-8.32.adoc | 5 --
.../pages/release-notes/_release-notes-8.33.adoc | 5 --
.../pages/release-notes/_release-notes-8.40.adoc | 7 ---
.../modules/ROOT/pages/release-notes/index.adoc | 54 ++++------------------
15 files changed, 30 insertions(+), 106 deletions(-)
diff --git
a/drools-docs/src/modules/ROOT/pages/KIE/BuildDeployUtilizeAndRun/_KIEBuilding-section.adoc
b/drools-docs/src/modules/ROOT/pages/KIE/BuildDeployUtilizeAndRun/_KIEBuilding-section.adoc
index 2a65195fa1..d3b4ffd3eb 100644
---
a/drools-docs/src/modules/ROOT/pages/KIE/BuildDeployUtilizeAndRun/_KIEBuilding-section.adoc
+++
b/drools-docs/src/modules/ROOT/pages/KIE/BuildDeployUtilizeAndRun/_KIEBuilding-section.adoc
@@ -453,7 +453,7 @@ The `KieResources` provides many convenient factory methods
to convert an ``Inpu
.KieResources
image::KIE/BuildDeployUtilizeAndRun/KieResources.png[align="center"]
-NOTE: `URLResource` is no longer available with Drools 8 series, to ensure a
more reproducible knowledge base build (avoiding remote URLs) and for better
security. If you used `URLResource` in the past, you can manage the local-fetch
of the remote resource externally to your Drools application, so to limit
Drools build concerns to local resources containing knowledge assets.
+NOTE: `URLResource` is no longer available since Drools 8, to ensure a more
reproducible knowledge base build (avoiding remote URLs) and for better
security. If you used `URLResource` in the past, you can manage the local-fetch
of the remote resource externally to your Drools application, so to limit
Drools build concerns to local resources containing knowledge assets.
Normally the type of a `Resource` can be inferred from the extension of the
name used to add it to the ``KieFileSystem``.
However it also possible to not follow the Kie conventions about file
extensions and explicitly assign a specific `ResourceType` to a `Resource` as
shown below:
diff --git
a/drools-docs/src/modules/ROOT/pages/KIE/BuildDeployUtilizeAndRun/_rule-unit-api.adoc
b/drools-docs/src/modules/ROOT/pages/KIE/BuildDeployUtilizeAndRun/_rule-unit-api.adoc
index 341493adcf..ad2e285643 100644
---
a/drools-docs/src/modules/ROOT/pages/KIE/BuildDeployUtilizeAndRun/_rule-unit-api.adoc
+++
b/drools-docs/src/modules/ROOT/pages/KIE/BuildDeployUtilizeAndRun/_rule-unit-api.adoc
@@ -2,7 +2,7 @@
= Rule Unit API
-Previous sections in this chapter explained traditional KIE APIs to use
{RULE_ENGINE}. However, as introduced in
xref:getting-started/index.adoc#first-rule-project_getting-started[First Rule
Project], Rule Unit is a new and recommended style for implementing rules in
{PRODUCT} 8.
+Previous sections in this chapter explained traditional KIE APIs to use
{RULE_ENGINE}. However, as introduced in
xref:getting-started/index.adoc#first-rule-project_getting-started[First Rule
Project], Rule Unit is a new and recommended style for implementing rules since
{PRODUCT} 8.
A rule unit is an atomic module defining a set of rules and a set of strongly
typed *data sources* through which the facts processed by the rules are
inserted. The *data sources* of 2 kinds: `DataStream` and `DataStore` which
will be described later in this section.
diff --git
a/drools-docs/src/modules/ROOT/pages/KIE/BuildDeployUtilizeAndRun/_rule-unit-dsl.adoc
b/drools-docs/src/modules/ROOT/pages/KIE/BuildDeployUtilizeAndRun/_rule-unit-dsl.adoc
index 5f2d397d3c..405ae60f21 100644
---
a/drools-docs/src/modules/ROOT/pages/KIE/BuildDeployUtilizeAndRun/_rule-unit-dsl.adoc
+++
b/drools-docs/src/modules/ROOT/pages/KIE/BuildDeployUtilizeAndRun/_rule-unit-dsl.adoc
@@ -2,7 +2,7 @@
= Rule Unit DSL
-In addition to the standard Rule Unit API, {PRODUCT} 8 offers an alternative
way of writing rules in combination with Rule Unit.
+In addition to the standard Rule Unit API, {PRODUCT} offers an alternative way
of writing rules in combination with Rule Unit.
You can now define the rules for Rule Units using a dedicated set of Java APIs.
TIP: As an end-user, you can think of the Rule Unit DSL as an alternative to
DRL, in order to define your rules with an internal DSL using Java.
diff --git
a/drools-docs/src/modules/ROOT/pages/_artifacts/document-attributes-drools.adoc
b/drools-docs/src/modules/ROOT/pages/_artifacts/document-attributes-drools.adoc
index d9c6ce473d..68c3f5edad 100644
---
a/drools-docs/src/modules/ROOT/pages/_artifacts/document-attributes-drools.adoc
+++
b/drools-docs/src/modules/ROOT/pages/_artifacts/document-attributes-drools.adoc
@@ -1,22 +1,9 @@
-// Do NOT delete repeated or superfluous variables unless the same can be
deleted from all other attributes docs (for DM, PAM, jBPM, etc.). All
attributes here are in use in product docs at this time, and as we single
source, we need those same variables to render appropriately for Drools. But do
please correct and add info where necessary. (Stetson, 2 Aug 2018)
-
:PRODUCT: Drools
-:PRODUCT_SHORT: Drools
:PRODUCT_INIT: drools
-:PRODUCT_INIT_CAP: DROOLS
-:PRODUCT_INIT_BA: drools
-:PRODUCT_INIT_CAP_BA: DROOLS
-:PRODUCT_DROOLS: Drools
-
-:PRODUCT_OLD: Drools
-:URL_COMPONENT_PRODUCT_OLD: drools
:PRODUCT_VERSION: {COMMUNITY_VERSION}
:PRODUCT_VERSION_LONG: {COMMUNITY_VERSION_LONG}
:PRODUCT_FILE: {PRODUCT_INIT}-{COMMUNITY_VERSION_LONG}
-:PRODUCT_FILE_BA: {PRODUCT_INIT_BA}-{COMMUNITY_VERSION_LONG}
-
-:URL_COMPONENT_PRODUCT: drools
:RULE_ENGINE: Drools rule engine
diff --git
a/drools-docs/src/modules/ROOT/pages/_artifacts/document-attributes.adoc
b/drools-docs/src/modules/ROOT/pages/_artifacts/document-attributes.adoc
index f77761a200..b53ca7c2e2 100644
--- a/drools-docs/src/modules/ROOT/pages/_artifacts/document-attributes.adoc
+++ b/drools-docs/src/modules/ROOT/pages/_artifacts/document-attributes.adoc
@@ -1,17 +1,7 @@
-
-:REBUILT: Tuesday, April 05, 2022
-
-
-:ENTERPRISE_VERSION: 7.12
-:ENTERPRISE_VERSION_LONG: 7.12.0
-:COMMUNITY_VERSION: 7.59
-:COMMUNITY_VERSION_LONG: 7.59.0
+:COMMUNITY_VERSION: 10.0
+:COMMUNITY_VERSION_LONG: 10.0.0
:COMMUNITY_VERSION_FINAL: {COMMUNITY_VERSION_LONG}.Final
-:COMMUNITY_VERSION_BRANCH: 7.59.x
-:ENTERPRISE_VERSION_SHORT: 712
-
-// For copyright
-:YEAR: 2022
+:COMMUNITY_VERSION_BRANCH: 10.0.x
ifdef::DROOLS,JBPM,OP[]
:MAVEN_ARTIFACT_VERSION: {COMMUNITY_VERSION_FINAL}
diff --git
a/drools-docs/src/modules/ROOT/pages/getting-started/_first-rule-project.adoc
b/drools-docs/src/modules/ROOT/pages/getting-started/_first-rule-project.adoc
index 5b729135ba..1b66f452ae 100644
---
a/drools-docs/src/modules/ROOT/pages/getting-started/_first-rule-project.adoc
+++
b/drools-docs/src/modules/ROOT/pages/getting-started/_first-rule-project.adoc
@@ -11,7 +11,7 @@ This guide walks you through the process of creating a simple
Drools application
== Creating a project with maven archetype
-You can choose a style of rule project from Rule Unit or traditional style.
Rule Unit is a new style that is recommended for microservices and cloud native
applications. Traditional style is the same as Drools 7. Both styles are
supported in Drools 8.
+You can choose a style of rule project from Rule Unit or traditional style.
Rule Unit is a new style that is recommended for microservices and cloud native
applications. The traditional style has been used since Drools 7. Both styles
are supported in Drools 10.
=== Rule Unit style
diff --git
a/drools-docs/src/modules/ROOT/pages/language-reference/_drl-rules.adoc
b/drools-docs/src/modules/ROOT/pages/language-reference/_drl-rules.adoc
index 17904986f6..33aa0bd014 100644
--- a/drools-docs/src/modules/ROOT/pages/language-reference/_drl-rules.adoc
+++ b/drools-docs/src/modules/ROOT/pages/language-reference/_drl-rules.adoc
@@ -54,7 +54,7 @@ Each rule must have a unique name within the rule unit. If
you use the same rule
[id="new-and-traditional-syntax_{context}"]
== New and traditional syntax
-In Drools 8, we promote a new DRL syntax based on rule unit, data source, and
OOPath. Hence, you will see such a new syntax in DRL syntax examples. However,
Drools 8 still fully supports traditional DRL syntax that has been used in
version 7 and prior.
+In Drools 10, we promote a new DRL syntax based on rule unit, data source, and
OOPath. Hence, you will see such a new syntax in DRL syntax examples. However,
Drools 10 still fully supports traditional DRL syntax that has been used in
prior versions.
.Example rule for loan application with traditional syntax
[source]
diff --git
a/drools-docs/src/modules/ROOT/pages/migration-guide/_missing_features_components.adoc
b/drools-docs/src/modules/ROOT/pages/migration-guide/_missing_features_components.adoc
index 7db762abcb..d4ffd56900 100644
---
a/drools-docs/src/modules/ROOT/pages/migration-guide/_missing_features_components.adoc
+++
b/drools-docs/src/modules/ROOT/pages/migration-guide/_missing_features_components.adoc
@@ -3,7 +3,7 @@
[id='kie-server_{context}']
== {KIE_SERVER}
-{KIE_SERVER} is retired and no longer a component of {PRODUCT} 8. If your
system is working on {KIE_SERVER} with {PRODUCT} 7, consider migration to
https://kogito.kie.org/[{KOGITO}].
+{KIE_SERVER} is retired and no longer a component since {PRODUCT} 8. If your
system is working on {KIE_SERVER} with {PRODUCT} 7, consider migration to
https://kogito.kie.org/[{KOGITO}].
While {KIE_SERVER} hosts multiple kjar containers, One {KOGITO} instance hosts
one domain service. Hence, you would create {KOGITO} project per kjar
container, which would be microservice style.
@@ -12,7 +12,7 @@ You can find the detailed migration steps in the next
sections, xref:con-migrati
[id='business-central_{context}']
== {BUSINESS_CENTRAL}
-{BUSINESS_CENTRAL} is retired and no longer a component of {PRODUCT} 8. For
asset management, the usual version control system is recommended, for example,
git. For editors,
https://marketplace.visualstudio.com/items?itemName=kie-group.vscode-extension-kogito-bundle[VS
Code Kogito extension] is recommended.
+{BUSINESS_CENTRAL} is retired and no longer a component since {PRODUCT} 8. For
asset management, the usual version control system is recommended, for example,
git. For editors,
https://marketplace.visualstudio.com/items?itemName=kie-group.vscode-extension-kogito-bundle[VS
Code Kogito extension] is recommended.
[id='bpmn-integration_{context}']
== BPMN integration / Rule flow
diff --git
a/drools-docs/src/modules/ROOT/pages/migration-guide/_traditional-to-ruleunit.adoc
b/drools-docs/src/modules/ROOT/pages/migration-guide/_traditional-to-ruleunit.adoc
index 086ff068b4..9b91657610 100644
---
a/drools-docs/src/modules/ROOT/pages/migration-guide/_traditional-to-ruleunit.adoc
+++
b/drools-docs/src/modules/ROOT/pages/migration-guide/_traditional-to-ruleunit.adoc
@@ -1,10 +1,12 @@
[id='traditional-to-ruleunit_{context}']
-= Migrate to {PRODUCT} 8
+= Migrate to {PRODUCT} 10
-This guide explains how to migrate {PRODUCT} 7 projects to {PRODUCT} 8
projects.
+Firstly, migration from {PRODUCT} 8 to {PRODUCT} 10 is very simple. You just
need to change the version in `pom.xml`. All APIs and DRL syntax are compatible.
-Firstly, {PRODUCT} 8 supports {PRODUCT} 7 APIs and DRL syntax, so basically
you don't need to change your Java codes and rule assets. However, there are
some cautions in `pom.xml`.
+This guide rather focuses on how to migrate from {PRODUCT} 7 projects to
{PRODUCT} 10 projects.
+
+{PRODUCT} 10 supports {PRODUCT} 7 APIs and DRL syntax, so basically you don't
need to change your Java codes and rule assets. However, there are some
cautions in `pom.xml`.
Typical {PRODUCT} 6 or early 7 projects have pom dependencies like this.
@@ -36,11 +38,11 @@ But since {PRODUCT} 7.45.0, `drools-engine` and
`drools-engine-classic` have bee
</dependency>
----
-{PRODUCT} 8 made some module refactoring, so you may find some difficulty in
collecting dependencies. This aggregator dependency would help.
+Some module refactoring were made during the version upgrades, so you may find
some difficulty in collecting dependencies. This aggregator dependency would
help.
== Rule Unit
-As introduced in
xref:getting-started/index.adoc#first-rule-project_getting-started[First Rule
Project], using Rule Units is a recommended style for implementing rules in
{PRODUCT} 8. It will require some modifications to your codebase, but if you
are going to develop cloud-native applications, Rule Units are strongly
recommended, because {KOGITO} also works with Rule Units.
+As introduced in
xref:getting-started/index.adoc#first-rule-project_getting-started[First Rule
Project], using Rule Units is a recommended style for implementing rules in
{PRODUCT} 10. It will require some modifications to your codebase, but if you
are going to develop cloud-native applications, Rule Units are strongly
recommended, because {KOGITO} also works with Rule Units.
.Rule Unit pom.xml
[xml,subs=attributes+]
diff --git
a/drools-docs/src/modules/ROOT/pages/release-notes/_release-notes-10.0.adoc
b/drools-docs/src/modules/ROOT/pages/release-notes/_release-notes-10.0.adoc
new file mode 100644
index 0000000000..5a8a793a1e
--- /dev/null
+++ b/drools-docs/src/modules/ROOT/pages/release-notes/_release-notes-10.0.adoc
@@ -0,0 +1,5 @@
+== 10.0.0 release notes
+
+=== PLACE_HOLDER
+
+PLACE_HOLDER
\ No newline at end of file
diff --git
a/drools-docs/src/modules/ROOT/pages/release-notes/_release-notes-8.31.adoc
b/drools-docs/src/modules/ROOT/pages/release-notes/_release-notes-8.31.adoc
deleted file mode 100644
index b6c4bf6f3c..0000000000
--- a/drools-docs/src/modules/ROOT/pages/release-notes/_release-notes-8.31.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-== 8.31.0.Final release notes
-
-=== Security Manager support is removed
-
-Following the JDK Security Manager deprecation for removal in Java 17, since
version 8.31.0.Final {PRODUCT} no longer allows to define a Security Manager
for constraints evaluation and consequences execution.
\ No newline at end of file
diff --git
a/drools-docs/src/modules/ROOT/pages/release-notes/_release-notes-8.32.adoc
b/drools-docs/src/modules/ROOT/pages/release-notes/_release-notes-8.32.adoc
deleted file mode 100644
index 62c2196ba3..0000000000
--- a/drools-docs/src/modules/ROOT/pages/release-notes/_release-notes-8.32.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-== 8.32.0.Final release notes
-
-=== 'with' statement is retired
-
-'with' statement is no longer supported in DRL. It should be easily rewritten
with valid Java syntax.
\ No newline at end of file
diff --git
a/drools-docs/src/modules/ROOT/pages/release-notes/_release-notes-8.33.adoc
b/drools-docs/src/modules/ROOT/pages/release-notes/_release-notes-8.33.adoc
deleted file mode 100644
index d19d6041ba..0000000000
--- a/drools-docs/src/modules/ROOT/pages/release-notes/_release-notes-8.33.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-== 8.33.0.Final release notes
-
-=== `drools-engine` or `drools-ruleunits-engine` dependency is enough to
generate the executable model
-
-In order to generate the executable model with `kie-maven-plugin`,
`drools-model-compiler` was required in prior versions, but starting from
{PRODUCT} 8.33, `drools-engine` or `drools-ruleunits-engine` dependency is
enough to generate the executable model.
\ No newline at end of file
diff --git
a/drools-docs/src/modules/ROOT/pages/release-notes/_release-notes-8.40.adoc
b/drools-docs/src/modules/ROOT/pages/release-notes/_release-notes-8.40.adoc
deleted file mode 100644
index 652e9d61e6..0000000000
--- a/drools-docs/src/modules/ROOT/pages/release-notes/_release-notes-8.40.adoc
+++ /dev/null
@@ -1,7 +0,0 @@
-== 8.40.0.Final release notes
-
-=== `kie-maven-plugin` update with maven compiler release
-
-In order to make the `kie-maven-plugin` compatible with Maven-based project
using a more recent version of the JDK, the plugin will now also look at the
`maven.compiler.release` property to infer the language level to use during the
build, with precedence over the `java.version` property (old behaviour).
-
-When the `kie-maven-plugin` is used in a Maven-based project, we recommend NOT
to set the `drools.dialect.java.compiler.lnglevel` in your KJAR project, so
that the version of the JDK to be used is the one fully governed by the whole
Maven build (including Java source files).
diff --git a/drools-docs/src/modules/ROOT/pages/release-notes/index.adoc
b/drools-docs/src/modules/ROOT/pages/release-notes/index.adoc
index aecf038023..e7f73660f0 100644
--- a/drools-docs/src/modules/ROOT/pages/release-notes/index.adoc
+++ b/drools-docs/src/modules/ROOT/pages/release-notes/index.adoc
@@ -7,59 +7,21 @@ include::../_artifacts/document-attributes.adoc[]
[id='{context}']
= Release Notes
-This chapter contains the release notes for the {PRODUCT} 8-series.
+This chapter contains the release notes for the {PRODUCT} 10-series.
-For the release notes of the _previous releases_, you can refer to the
{PRODUCT} documentation of
link:https://docs.drools.org/7.73.0.Final/drools-docs/html_single/index.html#droolsreleasenoteschapter[version
7].
+For the release notes of the _previous releases_, you can refer to the
{PRODUCT} documentation of
link:https://docs.drools.org/8.44.0.Final/drools-docs/drools/release-notes/index.html[version
8].
-include::_release-notes-8.40.adoc[leveloffset=0]
+// This is a placeholder for adding the release notes per minor version
+// include::_release-notes-10.0.adoc[leveloffset=0]
-include::_release-notes-8.33.adoc[leveloffset=0]
-
-include::_release-notes-8.32.adoc[leveloffset=0]
-
-include::_release-notes-8.31.adoc[leveloffset=0]
-
-== Drools 8-series release notes
-
-Drools 8-series is a natural evolution of the 7.x-stream, incorporating many
features and lessons learned integrating with Kogito and many cloud-native use
cases.
-
-=== Rule Unit
-
-Rule Unit is a central paradigm in the Drools 8-series.
-You can refer the xref:migration-guide/index.adoc[Migration guide chapter] for
more information about Rule Unit.
+== Drools 10-series release notes
=== Minimum requirements update
-JDK 11 is now the minimum Java version required to compile Drools and make use
of Drools.
+JDK 17 is now the minimum Java version required to compile Drools and make use
of Drools.
-Maven `3.8.6` is now the minimum Maven version required to build Drools from
source, or using `kie-ci` APIs.
+Maven `3.8.6` is the minimum Maven version required to build Drools from
source, or using `kie-ci` APIs.
=== `drools-mvel` and `drools-engine-classic` are deprecated
-`drools-mvel` is now deprecated in favor of the executable model. It also
means `drools-engine` is recommended instead of deprecated
`drools-engine-classic` that contains `drools-mvel`. You can still use MVEL
syntax in your rules, so it doesn't affect how to write rules.
-
-=== Spreadsheet decision tables file extensions
-
-All the files with `.xls`, `.xlsx` and `.csv` extensions were considered and
parsed as decision tables. In general, this was a too strong assumption,
breaking projects containing random excel files that are not decision tables
and generating artificial compile-time errors. To prevent such problems the
filename extension policy has been changed, considering and processing files as
decision tables only if their extension is prepended with `.drl`. In other
words, **only** files with `.drl.x [...]
-
-=== Security Manager deprecation
-
-The {PRODUCT} features related to the JDK Security Manager will not be further
developed, as starting with JDK17, the Java Platform has deprecated the
Security Manager for removal.
-You can refer the xref:KIE/index.adoc#_securitymanager[Security Manager
chapter] for more information.
-
-=== KIE Marshallers notice
-
-The `KieMarshallers` are still present and working as expected on the release
of the Drools 8-series, however we are currently exploring alternative
solutions more idiomatic to cloud-native use cases.
-
-=== {KIE_SERVER} is retired
-{KIE_SERVER} is no longer a component of {PRODUCT} 8. For migration, see
xref:migration-guide/index.adoc#kie-server_migration-guide[Migration guide
chapter].
-
-=== {BUSINESS_CENTRAL} is retired
-{BUSINESS_CENTRAL} is no longer a component of {PRODUCT} 8. For migration,
see xref:migration-guide/index.adoc#business-central_migration-guide[Migration
guide chapter].
-
-=== OSGi support is retired
-{PRODUCT} 8 no longer provides out of the box OSGi support in its modules.
-
-== Previous release notes
-
-For the release notes of the previous releases, you can refer the {PRODUCT}
documentation of
link:https://docs.drools.org/7.73.0.Final/drools-docs/html_single/index.html#droolsreleasenoteschapter[version
7].
\ No newline at end of file
+`drools-mvel` is deprecated since Drools 8 in favor of the executable model.
It also means drools-engine` is recommended instead of deprecated
`drools-engine-classic` that contains `drools-mvel`. You can still use MVEL
syntax in your rules, so it doesn't affect how to write rules.
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
