chore(deps): update dependency sass to v1.77.5

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): update dependency @sap/cds-dk to v7.9.3

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* tested new flow

* fix email ref in pdm service

* updates, new screenshot

* added date of birth

* new screenshot

* re-added sections

* Mermaid docs

* Apply suggestions from code review

---------

Co-authored-by: René Jeglinsky <[email protected]>

cds8: rm req.user.<tenant/locale> compat

Co-authored-by: sjvans <[email protected]>
Co-authored-by: René Jeglinsky <[email protected]>

No strings in INSERT.into and UPSERT.into

doc(completion): add fish shell entry

* Remove cds.Subscriber from mock users

* addtional cleanup

…es (#1027)

Users can't change `ordered` of `DefaultOutboxOrdered` and
`DefaultOutboxUnordered`.  But the documentation is not _that_ clear
about that the first time reading this document.

This commit adds the default and non-changable values for `ordered`
for these two default outboxes and mentions that they can't be changed
in the option description.

A source-code line was cut off.

There were two snippets that were not consistent in the naming of their
context variable.  In one case, `ctx` did not exist, in the other,
`context` did not exist.

)

* Remove CdsDataStore documentation from PersistenceService chapter

PersistenceService is preferred over CdsDataStore. Also configuring custom CdsDataStoreConnector instances is not recommened anymore since we support additional PersistenceServices out-of-the-box meanwhile as well

* Update query-api.md

---------

Co-authored-by: René Jeglinsky <[email protected]>

* hard coded vs usr defined strlength

... make foot note clearer

* Update cds/types.md

Co-authored-by: Andre Meyering <[email protected]>

---------

Co-authored-by: Steffen Weinstock <[email protected]>
Co-authored-by: Andre Meyering <[email protected]>

See https://github.com/actions/configure-pages/releases

One snippet used `=` instead of `: `.
Change `# […]` to `# ...`

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

Add all facets to table

Co-authored-by: Christian Georgi <[email protected]>

We do not document limitations wrt. RIGHT|FULL OUTER JOINs and UNIONs any longer. These SQL constructs are not used by the CAP Java runtime. The limitations could be observed in view definitions and hence rather have to be documented in the CQL area.

* Add Git Bash on Windows disclaimer

* Move disclaimer to CAP on Azure section

* rework

* Update get-started/troubleshooting.md

---------

Co-authored-by: René Jeglinsky <[email protected]>

* SAP Document Management Service Plugin Documentation

Adding the documentation for SAP Document Management Service plugin

* Update plugins/index.md

* Update plugins/index.md

* Update plugins/index.md

* Update plugins/index.md

* Update plugins/index.md

* Changes requested

* Update index.md

* cosmetics

---------

Co-authored-by: Mahati Shankar <[email protected]>
Co-authored-by: Mahati Shankar <[email protected]>

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

Co-authored-by: René Jeglinsky <[email protected]>
Co-authored-by: Christian Georgi <[email protected]>

Version 8 is ESM only, which we can't run atm.

Update auditlog.md

There is a diagram in the Java CDS Data guide that does not really
bring any benefit.  Not just that: it does not match the text: singular/
plural forms do not match the described entities.

As no relation between the entities is shown, I suggest to remove it.

Co-authored-by: Mahati Shankar <[email protected]>

#1050)

fix typo and rearrange to avoid multiple plural-possessive-quotes in core-services.md

Spotted "servce" [sic] then thought I'd rearrange the phrase anyway to help avoid two plural-possessive-quotes in one phrase :-)

* remove req._

we have req.http now

* add header example + warning

* Update node.js/events.md

* Update node.js/events.md

---------

Co-authored-by: René Jeglinsky <[email protected]>
Co-authored-by: Mahati Shankar <[email protected]>

I've updated the Fiori screenshot of the "In a Nutshell" guide to use
the latest version of the cloud-sap-samples project.  I've also used
Safari and have sized the window to be the same as the previous
screenshot.

The PNG was optimized for smaller size.

While reading the section for the first time, I wondered why the next
sections talk about `/browse`. Where did it come from?
Turns out, I was lazy and didn't read the second CDS file.

With this commit, let's make it a little bit more clear that the
catalog service has a different URL.

)

If `cds add multitenancy` is run without the `--for production`,
local app development will not work out-of-the-box.

Because users may just copy&paste all snippets to play around, make the
step production-only and link the multitenancy guide.

Most snippets refer to a Java project's `application.yaml`.
This is often implicit knowledge, which has to be induced from the
surrounding context.  Let's make it more explicit.

If the user followed the previous section "Add CloudFoundry target platform",
the `cds-starter-cloudfoundry` dependency is added which causes all
endpoints to be authenticated by default.  That also means that if the
user starts their app, a username and password is requested as soon
as they open a service in their browser.

But since this is the "Getting Started" guide, users won't know which
username/password combination they are expected to use.

This is confusing. So let's mention a username that works.

Co-authored-by: René Jeglinsky <[email protected]>

Co-authored-by: René Jeglinsky <[email protected]>

…Books, 42)` (#1054)

#1056)

Co-authored-by: René Jeglinsky <[email protected]>

Update output of `cds-typer --help`, which has changed a lot since the former output of 0.4.0.

Co-authored-by: René Jeglinsky <[email protected]>

Co-authored-by: René Jeglinsky <[email protected]>

* Start a test server inside describe

* move tip and make it less prominent to avoid to much noise

* rephrase sentence

* Update node.js/cds-test.md

Co-authored-by: René Jeglinsky <[email protected]>

---------

Co-authored-by: Rene Jeglinsky <[email protected]>

* Update learning-sources.md

Add official SAP Learning Journeys available on learning.sap.com

* Update learning-sources.md

* docs(Java): Fix Intellij part: make it more generic

The latest Intellij version has a `Generated Sources Root` marker, that
should be used instead of `Sources Root`.

Also, all keyboard shortcuts may differ, so let's make the section
more generic.

* Apply suggestions from code review

Co-authored-by: René Jeglinsky <[email protected]>

---------

Co-authored-by: René Jeglinsky <[email protected]>

There were two problems with the snippets. The first was the missing
`Handler` suffix in the filename, which is used for the Java
`tiny-sample`, the second was that the class name didn't match the
filename, as is common and required in Java.

This commit fixes it. I have tested the guide the with changes and
it works.

Co-authored-by: Robin <[email protected]>

…1009)

* docs(Java): Remove file listings: they are error prone and outdated

In previous commits, I've adapted a few file listings as they were
outdated.  This commit removes a few of them, as they don't have
any benefit and are rather confusing if we ever change the initial
file layout again (e.g. rename `schema.cds` to `cds-model.cds` or
similar).

* Apply suggestions from code review

* Update java/getting-started.md

* Update java/getting-started.md

---------

Co-authored-by: René Jeglinsky <[email protected]>

more-troubleshooting

* Migration Guide for CAP Java 3.0 (#890)

* Changes in cds-maven-plugin (#893)

* Update migration.md

* Update java/migration.md

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* Fix typo

* Update migration.md

* Fixed wrong property order (#935)

* [CAP Java 3.0] Explain removal of classic MTX in migration guide (#942)

* Added table for removed properties (#936)

* Update migration.md

* Update migration.md

* Update migration.md

* Update java/migration.md

Co-authored-by: Marc Becker <[email protected]>

* Update java/migration.md

Co-authored-by: Marc Becker <[email protected]>

* Update migration.md

* Update java/migration.md

* Update java/migration.md

---------

Co-authored-by: Marc Becker <[email protected]>

* Update migration.md

* Update java/migration.md

* describing new semantics of `cds.outbox.persistent.enabled` (#987)

* Describe changes of goal generate (#993)

* Update migration.md

* Update migration.md

* cds.sql.hana.optimizationMode: hex

* Java 3 Migration: CqnSearchTermPredicate (#1015)

* [3.0] Removal of `cds-feature-xsuaa` (#918)

Co-authored-by: Marc Becker <[email protected]>

* Add removed property

* cqn(String) methods

* $user.tenant

* 3.0: Lazy localization by default (#1023)

* $user.tenant deprecation

* document cds.auditLog.personalData.throwOnMissingDataSubject change

* Update migration.md

* CqnSearchPredicate

* Session Context Variables

* Prohibit star-expand and inline-all (#1039)

* Apply suggestions from code review

Co-authored-by: Matthias Schur <[email protected]>

* Remove warning

* Update minimum versions in general docs

* [3.0] IAS support in Remote Services and IAS migration guide (#1047)

* ias scenarios

* ias scenarios

* ias scenarios

* Apply suggestions from code review

Co-authored-by: Marc Becker <[email protected]>

* extract details to security.md

* bullet point list

* Update java/cqn-services/remote-services.md

Co-authored-by: Marc Becker <[email protected]>

* Update java/cqn-services/remote-services.md

* Update java/cqn-services/remote-services.md

* Update java/migration.md

* Update java/security.md

* Update java/security.md

* Update java/security.md

* Update java/security.md

* Update java/security.md

* fix syntax

* added code block

* fix formatting

* cosmetics

---------

Co-authored-by: Marc Becker <[email protected]>
Co-authored-by: Mahati Shankar <[email protected]>
Co-authored-by: Mahati Shankar <[email protected]>

* Update java/migration.md

Co-authored-by: Mahati Shankar <[email protected]>

* added new default value of message service structured flag

* changed default value in java messaging docs

* fixed link

* Update migration.md

* Update java/migration.md

* Update java/migration.md

* Update java/migration.md

* cosmetics

---------

Co-authored-by: Markus Ofterdinger <[email protected]>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Adrian Görler <[email protected]>
Co-authored-by: René Jeglinsky <[email protected]>
Co-authored-by: Thomas Bonk <[email protected]>
Co-authored-by: Matthias Schur <[email protected]>
Co-authored-by: Stefan Henke <[email protected]>
Co-authored-by: Vladimir <[email protected]>
Co-authored-by: Mahati Shankar <[email protected]>
Co-authored-by: Mahati Shankar <[email protected]>
Co-authored-by: BraunMatthias <[email protected]>
Co-authored-by: Thomas Bonk <[email protected]>

* [3.x] cds-services-archetype improvements

* Update building.md

* Update building.md

* Add link to SAP Hana Cloud system limits

* improve

* switch from eg

* edit

* docs(Java): Update link to GraalVM guide

The documentation was split into tutorials and concept documentation.

* Update java/operating-applications/optimizing.md

Co-authored-by: Marc Becker <[email protected]>

---------

Co-authored-by: Marc Becker <[email protected]>

* Update learning-sources.md

Linking Discovery centre missions of BTP Developer's Guide

* Update get-started/learning-sources.md

---------

Co-authored-by: René Jeglinsky <[email protected]>

#1085)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Steffen Waldmann <[email protected]>

* edit synopsis

* make introduction clearer

* Update cds/index.md

Co-authored-by: Christian Georgi <[email protected]>

---------

Co-authored-by: Christian Georgi <[email protected]>