docs(Welcome): add testing section, fix typos, remove outdated (#7965)

Lukas742 · web-flow · commit 2b673c1d87a9 · 2025-11-20T10:37:24.000Z
diff --git a/docs/Welcome.mdx b/docs/Welcome.mdx
@@ -15,19 +15,19 @@ import { VersionTable } from '@sb/components/VersionTable';
 [![](https://badgen.net/badge/maintained%20with/lerna?color=purple)](https://lernajs.io/)
 [![](https://badgen.net/github/stars/UI5/webcomponents-react?icon=github&color=black)](https://github.com/UI5/webcomponents-react/stargazers)
 
-[Open Github Project](https://github.com/UI5/webcomponents-react)
+[Open GitHub Project](https://github.com/UI5/webcomponents-react)
 
 UI5 Web Components for React is a Fiori compliant React library built on top of the UI5 Web Components.
 With the help of UI5 Web Components for React, you can use UI5 Web Components as if they were native React components.
-In addition to that, UI5 Web Components for React is providing complex components and layouts on top of the UI5 Web Components.
+In addition to that, UI5 Web Components for React provides complex components and layouts on top of the UI5 Web Components.
 
 <TableOfContent />
 
 ## Requirements
 
 - [React](https://www.npmjs.com/package/react) and [React-DOM](https://www.npmjs.com/package/react-dom) (**18.0.0 or higher**)
 - [Node.js](https://nodejs.org/) (**LTS version**)
-- If you're using [TypeScript](https://www.typescriptlang.org/) we recommend version **4.7** or later.
+- If you're using [TypeScript](https://www.typescriptlang.org/), we recommend version **4.7** or later.
 
 ## End of Support for Version 1.x
 
@@ -38,8 +38,8 @@ The support for version 1.x of `ui5-webcomponents-react` has ended on **July 1,
 ### Tutorial
 
 You are new to UI5 Web Components for React and don't know where to start?<br />
-Then take a look at our [Tutorial Mission](https://developers.sap.com/mission.react-spa.html) at “SAP Developers”!
-There you get a first glimpse at how easy it is to create an Application with UI5 Web Components for React.<br />
+Then take a look at our [Tutorial Mission](https://developers.sap.com/mission.react-spa.html) at "SAP Developers"!
+There you will get a first glimpse at how easy it is to create an Application with UI5 Web Components for React.<br />
 In about an hour you will create a business dashboard from scratch and get familiar with some React basics in case you don't know them already.
 
 ### Examples & Templates
@@ -177,7 +177,7 @@ Available Themes:
 
 ### Configure Compact/Cozy setting
 
-UI5 Web Components supports `Compact` and `Cozy` mode. It is set to `Cozy` by default. To enable `Compact`, provide the css class `ui5-content-density-compact` to any of your HTML elements and it apply compact size to all of its children.
+UI5 Web Components supports `Compact` and `Cozy` mode. It is set to `Cozy` by default. To enable `Compact`, provide the css class `ui5-content-density-compact` to any of your HTML elements and it will apply compact size to all of its children.
 
 ```html
 <body class="ui5-content-density-compact">
@@ -189,8 +189,6 @@ UI5 Web Components supports `Compact` and `Cozy` mode. It is set to `Cozy` by de
 
 UI5 Web Components for React supports [TypeScript](https://www.typescriptlang.org/), therefore we also provide type interfaces for event parameters, public methods of `ui5-webcomponents`, and more.
 
-You can find all available interfaces of the main package [here](https://github.com/UI5/webcomponents-react/tree/main/packages/main/src/interfaces) and for charts [here](https://github.com/UI5/webcomponents-react/tree/main/packages/charts/src/interfaces).
-
 #### Example
 
 Small app with a popover opened by clicking a button including type declarations:
@@ -232,6 +230,11 @@ export default function App() {
 `@ui5/webcomponents` offers a variety of [feature (side-effect) imports](https://ui5.github.io/webcomponents/docs/advanced/using-features/) that are available with `@ui5/webcomponents-react` as well.
 To use them you have to make sure they are imported before any other imports!
 
+### Testing
+
+We recommend testing components and running E2E tests in real browsers, e.g. by using Cypress, as JSDom (and other virtual DOM implementations) have limited custom element support.
+You can find out more about testing with Cypress [here](?path=/docs/testing-with-cypress-setup--docs), where you can also learn how to use our custom Cypress commands.
+
 ### Support
 
 Feel free to open issues or ask us directly in the [`#webcomponents-react`](https://openui5.slack.com/archives/CSQEJ2J04) channel in the
