Merge branch 'main' into shared-db

Author: Akatuoro

.vitepress/config.js

@@ -106,8 +106,8 @@ config.rewrites = rewrites
 // Add custom capire info to the theme config
 config.themeConfig.capire = {
   versions: {
-    java_services: '3.8.1',
-    java_cds4j: '3.8.1'
+    java_services: '3.9.0',
+    java_cds4j: '3.9.0'
   },
   gotoLinks: [],
   maven_host_base: 'https://repo1.maven.org/maven2'

.vitepress/theme/styles.scss

@@ -57,7 +57,8 @@
     --vp-c-text-1: rgba(255, 255, 245, 0.86);
 
     /* brightness fine-tuned to turn #fff into --vp-c-bg */
-    img, svg.adapt-dark {
+    img, svg.adapt-dark,
+    video.bright { // assuming videos are usually dark, only darken them if marked as bright
       filter: brightness(.884) invert(1) hue-rotate(177deg)
     }
     img.mute-dark {

about/features.md

@@ -178,15 +178,15 @@ Following is an index of the features currently covered by CAP, with status and
 
 ### Events / Messaging
 
-|                                                                                                                                                             |  CDS  |   Node.js    | Java |
-|-------------------------------------------------------------------------------------------------------------------------------------------------------------|:-----:|:------------:|:----:|
-| [Declared Events in CDS](../cds/cdl#events)                                                                                                                 | <X/>  |     <X/>     | <X/> |
-| Mock Broker (to speed up local dev) [[Node.js](../node.js/messaging#file-based)\|[Java](../java/messaging#local-testing)]                                   | <Na/> |     <X/>     | <X/> |
-| SAP Event Mesh (For single-tenant apps) [[Node.js](../node.js/messaging#event-mesh-shared)\|[Java](../java/messaging#configuring-sap-event-mesh-support)]   | <Na/> |     <X/>     | <X/> |
-| SAP Cloud Application Event Hub (For single-tenant apps) [[Node.js](../node.js/messaging#event-broker)]                                                     | <Na/> | <X/><br>beta | <D/> |
-| Composite Messaging (routing by configuration) [[Node.js](../node.js/messaging#composite-messaging)\|[Java](../java/messaging#composite-messaging-service)] | <Na/> |     <X/>     | <X/> |
-| Import AsyncAPI                                                                                                                                             | <O/>  |              |      |
-| Export AsyncAPI                                                                                                                                             | <X/>  |              |      |
+|                                                                                                                                                             | CDS   | Node.js                   | Java                      |
+|-------------------------------------------------------------------------------------------------------------------------------------------------------------|:-----:|:-------------------------:|:-------------------------:|
+| [Declared Events in CDS](../cds/cdl#events)                                                                                                                 | <X/>  | <X/>                      | <X/>                      |
+| Mock Broker (to speed up local dev) [[Node.js](../node.js/messaging#file-based)\|[Java](../java/messaging#local-testing)]                                   | <Na/> | <X/>                      | <X/>                      |
+| [SAP Cloud Application Event Hub](../guides/messaging/event-broker)                                                                                            | <Na/> | <X/><br><sup>plugin</sup> | <X/><br><sup>plugin</sup> |
+| [SAP Event Mesh](../guides/messaging/event-mesh)                                                                                                            | <Na/> | <X/>                      | <X/>                      |
+| Composite Messaging (routing by configuration) [[Node.js](../node.js/messaging#composite-messaging)\|[Java](../java/messaging#composite-messaging-service)] | <Na/> | <X/>                      | <X/>                      |
+| Import AsyncAPI                                                                                                                                             | <O/>  |                           |                           |
+| Export AsyncAPI                                                                                                                                             | <X/>  |                           |                           |
 
 <span id="events-messaging-more" />
 

about/index.md

@@ -85,7 +85,7 @@ CAP provides mocked variants for several platform services out of the box, which
 | Database         | SQLite, H2 in-memory | SAP HANA, PostgreSQL             |
 | Authentication   | Mocked Auth          | SAP Identity Services            |
 | App Gateway      | None                 | SAP App Router                   |
-| Messaging        | File-based Queues    | SAP Event Hub, Kafka, Redis, ... |
+| Messaging        | File-based Queues    | SAP Cloud Appl. Event Hub, Kafka, Redis, ... |
 
 > [!tip]
 >
@@ -223,7 +223,7 @@ That initiative happened to be successful, and gave a boost to a steadily **grow
 - [Open Telemetry → SAP Cloud Logging, Dynatrace, ...](../plugins/#telemetry)
 - [Attachments → SAP Object Store /S3](../plugins/#attachments)
 - [Attachments → SAP Document Management Service](../plugins/#@cap-js/sdm)
-- [Messaging → SAP Cloud Application Event Hub](../plugins/#event-broker-plugin)
+- [Messaging → SAP Cloud Application Event Hub](../plugins/#event-hub)
 - [Change Tracking](../plugins/#change-tracking)
 - [Notifications](../plugins/#notifications)
 - [Audit Logging → SAP Audit Logging](../plugins/#audit-logging)

advanced/odata.md

@@ -1106,9 +1106,9 @@ Provide support for hierarchy attribute calculation and navigation, and allow th
 
 | Transformation                                | Description                                                      | Node.js |        Java        |
 |-----------------------------------------------|------------------------------------------------------------------|:-------:|:------------------:|
-| `com.sap.vocabularies.Hierarchy.v1.TopLevels` | generate a hierarchy based on recursive parent-child source data |  <Na/>  | <X/><sup>(1)</sup> |
-| `ancestors`                                   | return all ancestors of a set of start nodes in a hierarchy      |  <Na/>  | <X/><sup>(1)</sup> |
-| `descendants`                                 | return all descendants of a set of start nodes in a hierarchy    |  <Na/>  | <X/><sup>(1)</sup> |
+| `com.sap.vocabularies.Hierarchy.v1.TopLevels` | generate a hierarchy based on recursive parent-child source data |  <X/><sup>(1)</sup>  | <X/><sup>(1)</sup> |
+| `ancestors`                                   | return all ancestors of a set of start nodes in a hierarchy      |  <X/><sup>(1)</sup>  | <X/><sup>(1)</sup> |
+| `descendants`                                 | return all descendants of a set of start nodes in a hierarchy    |  <X/><sup>(1)</sup>  | <X/><sup>(1)</sup> |
 
 - <sup>(1)</sup> Beta feature, API may change
 

get-started/attic/grow-as-you-go.-md

@@ -15,10 +15,10 @@ As your project evolves, you would gradually add new features, for example as ou
 While we used SQLite in-memory databases and mocked authentication during development, we would use SAP HANA Cloud and a combination of App Router, IAS and/or XSUAA in production. We can quickly do so as follows:
 
 ```sh
-cds add hana,approuter,xsuaa --for production
+cds add hana,approuter,xsuaa
 ```
 
-This adds respective packages and configuration to your project. The content of your project, that is, models or code, doesn't change and doesn't have to be touched. The option  `--for production` controls that these service variants are only used when in production profile, that is, when the app is deployed to the cloud. Locally you continue to develop in airplane mode.
+This adds respective packages and configuration to your project with the `[production]` profile. The content of your project, that is, models or code, doesn't change and doesn't have to be touched. The profile controls that these service variants are only used when in production, that is, when the app is deployed to the cloud. Locally you continue to develop in airplane mode.
 
 
 
@@ -39,7 +39,7 @@ cds add mta
 If you are creating a SaaS application you also need to add support for tenant subscriptions and tenant upgrades. When a tenant subscribes, new database containers have to be bootstrapped along with other resources, like message channels. CAP provides the so-called MTX services which do that automatically in a sidecar micro service. You can add all required packages and configurations by:
 
 ```sh
-cds add multitenancy --for production
+cds add multitenancy
 ```
 
 [Learn more about multitenancy.](../guides/multitenancy/){.learn-more}

get-started/index.md

@@ -26,10 +26,10 @@ Follow the steps after this for a minimalistic local setup. Alternatively, you c
 
 ### Prerequisites
 
-- [Node.js](https://nodejs.org) — required for installing the `cds` command line interface.
-- [SQLite](https://sqlite.org) — included in macOS and Linux → [install it](https://sqlite.org/download.html) on Windows.
+- [Node.js](https://nodejs.org) — required for installing the `cds` command line interface
+- [SQLite](https://sqlite.org) — included in macOS and Linux → [install it](https://sqlite.org/download.html) on Windows
 - **A Terminal**{style="font-weight: 500"} — for using the `cds` command line interface (CLI)
-- **A Text Editor**{style="font-weight: 500"} → we recommend [VS Code](https://code.visualstudio.com) with [CDS plugin](../tools/cds-editors#vscode).
+- **A Text Editor**{style="font-weight: 500"} → we recommend [VS Code](https://code.visualstudio.com) with [CDS plugin](../tools/cds-editors#vscode)
 
 
 ### Installation
@@ -88,7 +88,7 @@ Follow the steps after this for a minimalistic local setup. Alternatively, you c
 
 ## Starting Projects
 
-- Use `cds init` to start a CAP project, and then open it in VSCode:
+- Use `cds init` to start a CAP project, and then open it in VS Code:
 
    ```sh
    cds init bookshop