This is an automated email from the ASF dual-hosted git repository. tiagobento pushed a commit to branch main in repository https://gitbox.apache.org/repos/asf/incubator-kie-website.git
commit 74fce529817bde985508beddfed4cddac6c75efc Author: Tiago Bento <[email protected]> AuthorDate: Mon Aug 10 16:07:18 2026 -0400 Give Kogito its own docs section at /kogito An overview, a get-started walkthrough and the topic guides, with its own sidebar. The overview keeps Kogito's character: the three "Kogito ergo ..." columns from the old kogito.github.io front page are embedded in the article as a component, with their graphics and the Cinzel display face, self-hosted like the site's other fonts. The Kogito mark is repainted to the KIE palette. --- docs/components/kogito/_category_.json | 6 -- docs/components/kogito/kogito.md | 30 ------ docs/kogito/get-started.md | 34 +++++++ docs/kogito/guides.md | 106 ++++++++++++++++++++++ docs/kogito/kogito.mdx | 23 +++++ docusaurus.config.ts | 1 + sidebars.ts | 1 + src/components/KogitoHighlights/index.tsx | 86 ++++++++++++++++++ src/components/KogitoHighlights/styles.module.css | 32 +++++++ src/css/custom.css | 25 +++++ src/pages/kogito.tsx | 5 - static/fonts/cinzel-latin-ext.woff2 | Bin 0 -> 8344 bytes static/fonts/cinzel-latin.woff2 | Bin 0 -> 15228 bytes static/img/kogito.svg | 2 +- static/img/kogito/homepage_graphic_1.png | Bin 0 -> 5163 bytes static/img/kogito/[email protected] | Bin 0 -> 11258 bytes static/img/kogito/homepage_graphic_2.png | Bin 0 -> 6054 bytes static/img/kogito/[email protected] | Bin 0 -> 12964 bytes static/img/kogito/homepage_graphic_3.png | Bin 0 -> 6546 bytes static/img/kogito/[email protected] | Bin 0 -> 39303 bytes 20 files changed, 309 insertions(+), 42 deletions(-) diff --git a/docs/components/kogito/_category_.json b/docs/components/kogito/_category_.json deleted file mode 100644 index 2405d71..0000000 --- a/docs/components/kogito/_category_.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "label": "Kogito", - "position": 5, - "collapsible": false, - "collapsed": false -} diff --git a/docs/components/kogito/kogito.md b/docs/components/kogito/kogito.md deleted file mode 100644 index 819d2e5..0000000 --- a/docs/components/kogito/kogito.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -id: kogito -title: Kogito -sidebar_position: 6 ---- - -# Kogito -Cloud-native business automation for building intelligent applications, backed by battle-tested capabilities. - - -# Kogito ergo cloud -Kogito (powered by jBPM) is designed from ground up to run at scale on cloud infrastructure. If you think about business automation think about the cloud as this is where your business logic lives these days. By taking advantage of the latest technologies (Quarkus, knative, etc.), you get amazingly fast boot times and instant scaling on orchestration platforms like Kubernetes. - - -# Kogito ergo domain -Kogito adapts to your business domain rather than the other way around. No more leaking abstraction of the tool into your client applications. Stay focused on what the business is about instead of being concerned with technology behind it. - -# Kogito ergo power -Kogito offers a powerful developer experience based on battle-tested components. Achieve instant developer efficiency by having: - -* Tooling embeddable wherever you need it -* Code generation taking care of 80% of the work -* Flexibility to customize, only use what you need -* Simplified local development with live reload - -# Examples -Kogito can be used in many ways, so to help you get started, we provide a wide range of examples demonstrating from simple hello world to more advanced use cases using DMN, BPMN, KNative, Serverless Workflow and more. Head to Kogito examples repository in GitHub and start exploring. The team is constantly updating this repository with new and exciting features as they are added to Kogito. - -# Documentation -Please refer to [Documentation](/documentation) for the latest walk through examples and documentation. diff --git a/docs/kogito/get-started.md b/docs/kogito/get-started.md new file mode 100644 index 0000000..2066dfb --- /dev/null +++ b/docs/kogito/get-started.md @@ -0,0 +1,34 @@ +--- +id: get-started +title: Get Started +sidebar_position: 1 +--- + +Everything you need to build and run your first Kogito service. + +## Prerequisites + +1. **An IDE** — [VS Code](https://code.visualstudio.com/Download) (preferred), + [IntelliJ IDEA](https://www.jetbrains.com/idea/download/) or + [Eclipse](https://www.eclipse.org/downloads/). +2. **JDK 17** — with `JAVA_HOME` set; [Temurin](https://adoptium.net/) works + well. Optionally [GraalVM](https://www.graalvm.org/) for native compilation. +3. **Maven 3.9+** — [Apache Maven](https://maven.apache.org/). The exact + versions behind a release are in the + [build instructions](/community/devs/build-10.2). + +## Then, in order + +1. **[Understand what Kogito is](pathname:///docs/10.2.x/kogito/#con-kogito-automation_kogito-creating-running)** + — what Kogito is, and when it becomes the core of your domain-specific + cloud-native services. +2. **[Build your first service](pathname:///docs/10.2.x/kogito/#chap-kogito-creating-running)** + — create a Maven project, design its logic with DMN and BPMN in the Kogito + modelers, then run the service and interact with it. +3. **[Read the example applications](pathname:///docs/10.2.x/kogito/#ref-kogito-app-examples_kogito-creating-running)** + — a sequence of applications of increasing complexity, covering + persistence, messaging with Kafka and data indexing. + +From here, the [guides](/kogito/guides) cover individual topics in depth, and +the [Kogito examples](https://github.com/apache/incubator-kie-kogito-examples/) +repository is worth keeping open alongside them. diff --git a/docs/kogito/guides.md b/docs/kogito/guides.md new file mode 100644 index 0000000..1f90c1d --- /dev/null +++ b/docs/kogito/guides.md @@ -0,0 +1,106 @@ +--- +id: guides +title: Guides +sidebar_position: 2 +--- + +You have gone through the [Get Started guides](/kogito/get-started). You are +now ready to dive into specific topic guides. + +## Tooling + +### [Kogito BPMN and DMN modelers](pathname:///docs/10.2.x/kogito/#con-kogito-modelers_kogito-creating-running) + +Kogito provides extensions and application graphical modelers that you can use +to design Business Process Model and Notation (BPMN) process models and +Decision Model and Notation (DMN) decision models for your Kogito services. + +## Decision services + +### [Developing decision services with Kogito](pathname:///docs/10.2.x/kogito/#collection-kogito-developing-decision-services) + +As a developer of business decisions, you can use Kogito business automation to +develop decision services using Decision Model and Notation (DMN) models, +Drools Rule Language (DRL) rules, XLS or XLSX spreadsheet decision tables, or a +combination of all three methods. + +### [Using DMN models in Kogito services](pathname:///docs/10.2.x/kogito/#chap-kogito-using-dmn-models) + +As a business analyst or business rules developer, you can use Decision Model +and Notation (DMN) to model a decision service graphically in a decision +requirements diagram (DRD). This diagram consists of one or more decision +requirements graphs (DRGs) that trace business decisions from start to finish, +with each decision node using logic defined in DMN boxed expressions such as +decision tables. + +### [Using DRL rules in Kogito services](pathname:///docs/10.2.x/kogito/#chap-kogito-using-drl-rules) + +As a developer of business decisions, you can define business rules using +Drools Rule Language (DRL) directly in free-form .drl text files. A DRL file +can contain one or more rules that define at a minimum the rule conditions +(when) and actions (then). + +### [Using spreadsheet decision tables in Kogito services](pathname:///docs/10.2.x/kogito/#chap-kogito-using-spreadsheet-decision-tables) + +As a developer of business decisions, you can define business rules in a +tabular format in spreadsheet decision tables and then include the spreadsheet +file in your Kogito project. These rules are compiled into Drools Rule Language +(DRL) for the decision service in your project. + +### [Decision engine in Kogito](pathname:///docs/10.2.x/kogito/#chap-kogito-decision-engine) + +As a developer of business decisions, your understanding of the decision engine +in Kogito can help you design more effective business assets and a more +scalable decision management architecture. The decision engine is the Kogito +component that stores, processes, and evaluates data to execute business rules +and to reach the decisions that you define. + +## Process services + +### [Developing process services with Kogito](pathname:///docs/10.2.x/kogito/#chap-kogito-developing-process-services) + +As a developer of business processes, you can use Kogito business automation to +develop process services using Business Process Model and Notation (BPMN) 2.0 +models. BPMN process models are graphical representations of the steps required +to achieve a business goal. You can design your BPMN processes with the Kogito +BPMN modeler in VS Code or import existing BPMN processes into your Kogito +projects for deployment and execution. + +### [BPMN 2.0 support in Kogito](pathname:///docs/10.2.x/kogito/#con-bpmn_kogito-developing-process-services) + +Business Process Model and Notation (BPMN) 2.0 is a standard established by the +Object Management Group (OMG) for describing and modeling business processes. + +### [Persistence in Kogito services](pathname:///docs/10.2.x/kogito/#con-persistence_kogito-developing-process-services) + +Kogito supports runtime persistence for preserving process data in your +services across application restarts. Kogito persistence is based on key-value +storage to persist data, such as active process nodes and process instance +variables. + +### [Kogito Management Console](pathname:///docs/10.2.x/kogito/#con-management-console_kogito-developing-process-services) + +The Kogito Management Console is a user interface for viewing the state of all +available Kogito services and managing process instances. You can use the +Management Console to view process, subprocess, and node instance details, +abort process instances, and view domain-specific process data. + +## Environment configuration + +### [Configuring Kogito supporting services and runtime capabilities](pathname:///docs/10.2.x/kogito/#chap-kogito-configuring) + +As a developer of business processes and decisions, you can configure Kogito +supporting services and runtime properties for advanced use cases with your +Kogito services. + +### [Using the Kogito Data Index Service](pathname:///docs/10.2.x/kogito/#con-data-index-service_kogito-configuring) + +Kogito provides a Data Index Service that stores all Kogito events related to +processes, tasks, and domain data. The Data Index Service is at the core of all +Kogito search, insight, and management capabilities. + +### [Using the Kogito Jobs Service](pathname:///docs/10.2.x/kogito/#con-jobs-service_kogito-configuring) + +Kogito provides a Jobs Service for scheduling Business Process Model and +Notation (BPMN) process events that are configured to be executed at a +specified time. These time-based events in a process model are known as jobs. diff --git a/docs/kogito/kogito.mdx b/docs/kogito/kogito.mdx new file mode 100644 index 0000000..c4f0e4e --- /dev/null +++ b/docs/kogito/kogito.mdx @@ -0,0 +1,23 @@ +--- +id: kogito +title: Kogito +sidebar_label: Overview +sidebar_position: 0 +--- + +import KogitoHighlights from "@site/src/components/KogitoHighlights"; + +Kogito is cloud-native business automation for building intelligent +applications, backed by battle-tested capabilities. + +New to Kogito? [Get Started](/kogito/get-started) walks you through building +and running your first service. + +<KogitoHighlights /> + +## Learn more + +- [Get Started](/kogito/get-started) — everything you need to build and run your first Kogito service. +- [Guides](/kogito/guides) — topic guides for building decision and process services. +- [Examples](https://github.com/apache/incubator-kie-kogito-examples/) — from hello world to advanced use cases with DMN, BPMN and Knative, constantly updated as features land. +- [Documentation](pathname:///docs/10.2.x/kogito/) — the Kogito documentation, published with every Apache KIE release. diff --git a/docusaurus.config.ts b/docusaurus.config.ts index 313e7b1..d4b9f70 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -78,6 +78,7 @@ const config: Config = { from: "/components/jbpm/getting_started", to: "/jbpm/getting-started", }, + { from: "/components/kogito", to: "/kogito/" }, ], // The docs plugin's `routeBasePath` was changed from "/docs" to "/", diff --git a/sidebars.ts b/sidebars.ts index d5bf1ee..354d7fd 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -16,6 +16,7 @@ const sidebars: SidebarsConfig = { droolsSidebar: [{ type: "autogenerated", dirName: "drools" }], optaplannerSidebar: [{ type: "autogenerated", dirName: "optaplanner" }], jbpmSidebar: [{ type: "autogenerated", dirName: "jbpm" }], + kogitoSidebar: [{ type: "autogenerated", dirName: "kogito" }], examplesSidebar: [{ type: "autogenerated", dirName: "examples"}], documentationSidebar: [{ type: "autogenerated", dirName: "documentation" }], downloadSidebar: [{ type: "autogenerated", dirName: "downloads" }], diff --git a/src/components/KogitoHighlights/index.tsx b/src/components/KogitoHighlights/index.tsx new file mode 100644 index 0000000..c473052 --- /dev/null +++ b/src/components/KogitoHighlights/index.tsx @@ -0,0 +1,86 @@ +import useBaseUrl from "@docusaurus/useBaseUrl"; +import Heading from "@theme/Heading"; + +import styles from "./styles.module.css"; + +type Highlight = { + title: string; + image: string; + body: React.ReactNode; +}; + +const HIGHLIGHTS: Highlight[] = [ + { + title: "Kogito ergo cloud", + image: "/img/kogito/homepage_graphic_1", + body: ( + <p> + Kogito is designed from ground up to run at scale on cloud + infrastructure. By taking advantage of the latest technologies (Quarkus, + Knative, etc.), you get amazingly fast boot times and instant scaling on + orchestration platforms like Kubernetes. + </p> + ), + }, + { + title: "Kogito ergo domain", + image: "/img/kogito/homepage_graphic_2", + body: ( + <p> + Kogito adapts to your business domain rather than the other way around. + No more leaking abstraction of the tool into your client applications. + Stay focused on what the business is about instead of being concerned + with technology behind it. + </p> + ), + }, + { + title: "Kogito ergo power", + image: "/img/kogito/homepage_graphic_3", + body: ( + <> + <p> + Kogito offers a powerful developer experience based on battle-tested + components: + </p> + <ul> + <li>Tooling embeddable wherever you need it</li> + <li>Code generation taking care of 80% of the work</li> + <li>Flexibility to customize, only use what you need</li> + <li>Simplified local development with live reload</li> + </ul> + </> + ), + }, +]; + +function HighlightColumn({ highlight }: { highlight: Highlight }): JSX.Element { + const image = useBaseUrl(`${highlight.image}.png`); + const image2x = useBaseUrl(`${highlight.image}@2x.png`); + return ( + <div className={styles.highlight}> + <img + className={styles.image} + src={image} + srcSet={`${image} 1x, ${image2x} 2x`} + alt="" + aria-hidden="true" + /> + <Heading as="h2" className={styles.title}> + {highlight.title} + </Heading> + {highlight.body} + </div> + ); +} + +/** The three "Kogito ergo ..." columns, embedded in the Kogito overview doc. */ +export default function KogitoHighlights(): JSX.Element { + return ( + <div className={styles.grid}> + {HIGHLIGHTS.map((highlight) => ( + <HighlightColumn key={highlight.title} highlight={highlight} /> + ))} + </div> + ); +} diff --git a/src/components/KogitoHighlights/styles.module.css b/src/components/KogitoHighlights/styles.module.css new file mode 100644 index 0000000..e812c91 --- /dev/null +++ b/src/components/KogitoHighlights/styles.module.css @@ -0,0 +1,32 @@ +.grid { + display: grid; + grid-template-columns: repeat(auto-fit, minmax(15rem, 1fr)); + gap: 2rem; + margin: 2rem 0; +} + +.highlight p:last-child, +.highlight ul:last-child { + margin-bottom: 0; +} + +.highlight ul { + padding-left: 1.1rem; +} + +.image { + width: 4.5rem; + height: auto; + margin-bottom: 0.75rem; +} + +/* Cinzel reads as carved rather than typed — the "Kogito ergo ..." motto + face. Caps set solid need a little tracking to breathe. */ +.title { + margin-bottom: 0.5rem; + font-family: "Cinzel", Georgia, serif; + font-size: 1.25rem; + font-weight: 600; + letter-spacing: 0.02em; + line-height: 1.15; +} diff --git a/src/css/custom.css b/src/css/custom.css index 372c03d..1c604f1 100644 --- a/src/css/custom.css +++ b/src/css/custom.css @@ -28,6 +28,31 @@ U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F, U+A720-A7FF; } +/* Cinzel, self-hosted alongside Quicksand (SIL Open Font License). Used only + for the "Kogito ergo ..." headings — its lowercase is small caps, so it is + a display face, not a text one. */ +@font-face { + font-family: 'Cinzel'; + font-style: normal; + font-weight: 600; + font-display: swap; + src: url('/fonts/cinzel-latin.woff2') format('woff2'); + unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, + U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, + U+2212, U+2215, U+FEFF, U+FFFD; +} + +@font-face { + font-family: 'Cinzel'; + font-style: normal; + font-weight: 600; + font-display: swap; + src: url('/fonts/cinzel-latin-ext.woff2') format('woff2'); + unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, + U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, + U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F, U+A720-A7FF; +} + html { scrollbar-gutter: stable; } diff --git a/src/pages/kogito.tsx b/src/pages/kogito.tsx deleted file mode 100644 index 330d507..0000000 --- a/src/pages/kogito.tsx +++ /dev/null @@ -1,5 +0,0 @@ -import {Redirect} from '@docusaurus/router'; - -export default function KogitoRedirect(): JSX.Element { - return <Redirect to="/components/kogito" />; -} diff --git a/static/fonts/cinzel-latin-ext.woff2 b/static/fonts/cinzel-latin-ext.woff2 new file mode 100644 index 0000000..9ccb351 Binary files /dev/null and b/static/fonts/cinzel-latin-ext.woff2 differ diff --git a/static/fonts/cinzel-latin.woff2 b/static/fonts/cinzel-latin.woff2 new file mode 100644 index 0000000..b48b912 Binary files /dev/null and b/static/fonts/cinzel-latin.woff2 differ diff --git a/static/img/kogito.svg b/static/img/kogito.svg index 2228a24..c3c76a4 100644 --- a/static/img/kogito.svg +++ b/static/img/kogito.svg @@ -1 +1 @@ -<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg"; viewBox="0 0 1024 1024"><defs><style>.cls-1{fill:#085870;}.cls-2{fill:#fff;}.cls-3{fill:#f5891f;}.cls-4{fill:#97d4e8;}</style></defs><title>kogito_icon_rgb_color_default</title><path class="cls-1" d="M929.37,30.5A70.31,70.31,0,0,0,872.19,1C868.09,1,738,23.67,738,23.67a70.15,70.15,0,0,0-48.1,33.25L668,93.77c-48.41-42.46-101.74-64.7-156-64.7S404.43,51.31,356,93.77L334.11,56.92A70.13,70.13,0,0,0,286,23.67S155.9,1,151.8 [...] \ No newline at end of file +<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg"; viewBox="0 0 1024 1024"><defs><style>.cls-2{fill:#fff;}.cls-3{fill:#f5891f;}.cls-4{fill:#97d4e8;}</style></defs><title>kogito_icon_rgb_color_default</title><path fill="#085870" d="M929.37,30.5A70.31,70.31,0,0,0,872.19,1C868.09,1,738,23.67,738,23.67a70.15,70.15,0,0,0-48.1,33.25L668,93.77c-48.41-42.46-101.74-64.7-156-64.7S404.43,51.31,356,93.77L334.11,56.92A70.13,70.13,0,0,0,286,23.67S155.9,1,151.81,1A70.19,70.19,0,0, [...] \ No newline at end of file diff --git a/static/img/kogito/homepage_graphic_1.png b/static/img/kogito/homepage_graphic_1.png new file mode 100644 index 0000000..c69fbb0 Binary files /dev/null and b/static/img/kogito/homepage_graphic_1.png differ diff --git a/static/img/kogito/[email protected] b/static/img/kogito/[email protected] new file mode 100644 index 0000000..3045b97 Binary files /dev/null and b/static/img/kogito/[email protected] differ diff --git a/static/img/kogito/homepage_graphic_2.png b/static/img/kogito/homepage_graphic_2.png new file mode 100644 index 0000000..3ecd045 Binary files /dev/null and b/static/img/kogito/homepage_graphic_2.png differ diff --git a/static/img/kogito/[email protected] b/static/img/kogito/[email protected] new file mode 100644 index 0000000..36d3000 Binary files /dev/null and b/static/img/kogito/[email protected] differ diff --git a/static/img/kogito/homepage_graphic_3.png b/static/img/kogito/homepage_graphic_3.png new file mode 100644 index 0000000..65b0508 Binary files /dev/null and b/static/img/kogito/homepage_graphic_3.png differ diff --git a/static/img/kogito/[email protected] b/static/img/kogito/[email protected] new file mode 100644 index 0000000..1b03e70 Binary files /dev/null and b/static/img/kogito/[email protected] differ --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
