maxGraph · tbouffard · Apr 30, 2025 · Apr 29, 2025 · Apr 30, 2025 · Apr 30, 2025
diff --git a/README.md b/README.md
@@ -58,6 +58,13 @@ yarn
 ```
 yarn add @maxgraph/core
 ```
+
+`maxGraph` is written in TypeScript and provides type definitions for seamless integration into TypeScript applications.
+
+Compatibility of the npm package:
+- The JavaScript code conforms to `ES2020` and is provided as ES Modules only
+- TypeScript integration requires **TypeScript 3.8** or higher
+
 <!-- END OF 'copied into packages/website/docs/getting-started.mdx' -->
 
 ## Getting Started
@@ -159,13 +166,6 @@ Note that they are based on `maxGraph` features, which require the use of [CSS a
 For a complete guide, see the [dedicated migration page](packages/website/docs/usage/migrate-from-mxgraph.md).
 
 
-## TypeScript support
-
-`maxGraph` is written in TypeScript and provides type definitions so `maxGraph` can be easily integrated into TypeScript applications.
-
-`maxGraph` requires **TypeScript 3.8** or greater.
-
-
 ## Support
 
 <!-- copied into packages/website/docs/getting-started.mdx -->

diff --git a/packages/website/docs/getting-started.mdx b/packages/website/docs/getting-started.mdx
@@ -36,6 +36,14 @@ Install the latest version of `maxGraph` from the [npm registry](https://www.npm
   </TabItem>
 </Tabs>
 
+:::info
+`maxGraph` is written in TypeScript and provides type definitions for seamless integration into TypeScript applications.
+
+Compatibility of the npm package:
+- The JavaScript code conforms to `ES2020` and is provided as ES Modules only
+- TypeScript integration requires **TypeScript 3.8** or higher
+:::
+
 [//]: # (END OF 'extract of <rootdir>/README.md')
 
 

diff --git a/packages/website/docs/intro.md b/packages/website/docs/intro.md
@@ -32,15 +32,15 @@ To visualize the documentation for a specific version (and the corresponding dem
 :::
 
 
-## Quick Start
-
-To know how to install maxGraph and how to implement a first example, take a look at the [Getting Started](./getting-started.mdx) guide.
-
+## Documentation Structure
 
-## Next Steps
+This documentation is organized into several sections:
+- **[Manual](./manual/index.md)**: Describes the core concepts and architecture of `maxGraph`
+- **[Tutorials](./category/tutorials)**: Provides step-by-step guides to help you learn the basics of `maxGraph`
+- **[Usage](./category/usage)**: Contains detailed documentation and examples for implementing specific features
+- **[Development](./category/development)**: Explains how to build and contribute to `maxGraph` (for contributors and maintainers)
 
-Let's continue with the [Manual](./manual/index.md) to understand the `maxGraph` concepts.
-
-For more information on how to use specific features, please refer to the [Usage](/docs/category/usage) documentation.
 
+## Quick Start
 
+To know how to install maxGraph and how to implement a first example, take a look at the [Getting Started](./getting-started.mdx) guide.