Skip to content

Commit 454bd27

Browse files
committed
chore: update 1.5, 1.6, 1.7 and 2.0 docs
1 parent 927dc22 commit 454bd27

File tree

185 files changed

+3720
-3892
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

185 files changed

+3720
-3892
lines changed

.vscode/settings.json

Lines changed: 38 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,40 @@
11
{
2-
"editor.formatOnSave": true,
3-
"editor.renderWhitespace": "all",
4-
// Configure glob patterns for excluding files and folders.
5-
// For example, the files explorer decides which files and folders to show
6-
// or hide based on this setting.
7-
// Read more about glob patterns [here](https://code.visualstudio.com/docs/editor/codebasics#_advanced-search-options).
8-
"files.exclude": {
9-
"**/.git": true,
10-
"**/.svn": true,
11-
"**/.hg": true,
12-
"**/CVS": true,
13-
"**/.DS_Store": true
14-
},
15-
// Configure glob patterns of file paths to exclude from file watching.
16-
// Patterns must match on absolute paths
17-
// (i.e. prefix with ** or the full path to match properly).
18-
// Changing this setting requires a restart.
19-
// When you experience Code consuming lots of cpu time on startup,
20-
// you can exclude large folders to reduce the initial load.
21-
"files.watcherExclude": {
22-
"**/.git/objects/**": true,
23-
"**/.git/subtree-cache/**": true,
24-
"**/node_modules/**": true,
25-
"**/tmp/**": true,
26-
"**/bower_components/**": true,
27-
"**/dist/**": true
28-
},
29-
// Configure glob patterns for excluding files and folders in searches.
30-
// Inherits all glob patterns from the `files.exclude` setting.
31-
// Read more about glob patterns [here](https://code.visualstudio.com/docs/editor/codebasics#_advanced-search-options).
32-
"search.exclude": {
33-
"**/node_modules": true,
34-
"**/bower_components": true
35-
},
36-
"javascript.preferences.importModuleSpecifier": "relative",
37-
"javascript.updateImportsOnFileMove.enabled": "always",
38-
"typescript.preferences.importModuleSpecifier": "relative",
39-
"typescript.updateImportsOnFileMove.enabled": "always"
2+
"editor.formatOnSave": true,
3+
"editor.renderWhitespace": "all",
4+
// Configure glob patterns for excluding files and folders.
5+
// For example, the files explorer decides which files and folders to show
6+
// or hide based on this setting.
7+
// Read more about glob patterns [here](https://code.visualstudio.com/docs/editor/codebasics#_advanced-search-options).
8+
"files.exclude": {
9+
"**/.git": true,
10+
"**/.svn": true,
11+
"**/.hg": true,
12+
"**/CVS": true,
13+
"**/.DS_Store": true
14+
},
15+
// Configure glob patterns of file paths to exclude from file watching.
16+
// Patterns must match on absolute paths
17+
// (i.e. prefix with ** or the full path to match properly).
18+
// Changing this setting requires a restart.
19+
// When you experience Code consuming lots of cpu time on startup,
20+
// you can exclude large folders to reduce the initial load.
21+
"files.watcherExclude": {
22+
"**/.git/objects/**": true,
23+
"**/.git/subtree-cache/**": true,
24+
"**/node_modules/**": true,
25+
"**/tmp/**": true,
26+
"**/bower_components/**": true,
27+
"**/dist/**": true
28+
},
29+
// Configure glob patterns for excluding files and folders in searches.
30+
// Inherits all glob patterns from the `files.exclude` setting.
31+
// Read more about glob patterns [here](https://code.visualstudio.com/docs/editor/codebasics#_advanced-search-options).
32+
"search.exclude": {
33+
"**/node_modules": true,
34+
"**/bower_components": true
35+
},
36+
"javascript.preferences.importModuleSpecifier": "relative",
37+
"javascript.updateImportsOnFileMove.enabled": "always",
38+
"typescript.preferences.importModuleSpecifier": "relative",
39+
"typescript.updateImportsOnFileMove.enabled": "always"
4040
}

dev/docs/30-components/tree-item.mdx

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
title: Tree Item
3+
description: Beschreibung, Spezifikation und Beispiele für die Tree-Komponente.
4+
tags:
5+
- Tree Item
6+
- Beschreibung
7+
- Spezifikation
8+
- Beispiele
9+
---
10+
11+
import Readme from '../../readmes/tree-item/readme.md';
12+
import { Configurator } from '@site/src/components/Configurator';
13+
import { LiveEditorCompact } from '@site/src/components/LiveEditorCompact';
14+
15+
<Readme />

dev/docs/30-components/tree.mdx

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
title: Tree
3+
description: Beschreibung, Spezifikation und Beispiele für die Tree-Komponente.
4+
tags:
5+
- Tree
6+
- Beschreibung
7+
- Spezifikation
8+
- Beispiele
9+
---
10+
11+
import Readme from '../../readmes/tree/readme.md';
12+
import { Configurator } from '@site/src/components/Configurator';
13+
import { LiveEditorCompact } from '@site/src/components/LiveEditorCompact';
14+
15+
<Readme />
Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
# Migration
2+
3+
## Introduction
4+
5+
New major versions of KoliBri are developed with the aim of simplifying maintenance and support and promoting further development.
6+
7+
This means that components, features or functionalities may be removed and technological prerequisites created to promote future innovative change.
8+
9+
- **Maintenance and care strategy:**<br/>
10+
We will always maintain the latest and previous major version of KoliBri. This means that we will fix bugs and close security gaps for these versions. For all other versions, we will no longer provide bug fixes or security updates without further notice.
11+
- **Further development:**<br/>
12+
We will always continue to develop the latest major version of KoliBri. This means that we will provide new features and functionalities for these versions. For all other versions, we will no longer provide any new features or functionalities without further ado.
13+
- **Save an executable version before migration:**<br/>
14+
Before the migration takes place, we recommend checking in an executable version so that there are no uncommitted changes to the source code to be migrated. This means that all changes can be easily tracked and checked during and after the migration.
15+
- **Migrationstool:**<br/>
16+
We provide a migration tool that generally supports the migration of source code with KoliBri. This tool is able to migrate most breaking changes automatically. Further information can be found in the [Tool-Dokumentation (EN)](https://www.npmjs.com/package/@public-ui/kolibri-cli).
17+
- **Help and feedback:**<br/>
18+
If there are any problems with the migration, we are happy to help. Please open an [Issue on GitHub](https://github.com/public-ui/kolibri/issues/new/choose).
19+
20+
## Migration from version 1 to version 2
21+
22+
### Notes on upgrading to version 2
23+
24+
1. **New features in version 2 already available from version 1.7:**<br/>
25+
Most of the new features introduced in version 2 are already available from version 1.7 and higher. This means that applications based on version 1.7 or higher may already have the necessary functions to enable a smooth migration.
26+
27+
2. **Removed properties, components and functionalities were already marked as obsolete in version 1.7 and higher:**<br/>
28+
All features, components and functionalities that were removed in version 2 were already marked as deprecated in version 1.7 and higher. So if you have regularly updated your code base, you should already be prepared to replace these elements.
29+
30+
3. **Migration from version 1.7 minimizes potential changes:**<br/>
31+
A migration from version 1.7 and higher to version 2 will probably require the least adjustments. The likelihood of incompatibilities is low, as most changes and removals have already been marked as obsolete in previous versions.
32+
33+
4. **Migration from version 1.4 is possible:**<br/>
34+
Although a migration from version 1.7 is recommended, it is also possible to migrate from version 1.4 to version 2. Please note, however, that this may require additional adjustments, as some of the necessary functions may only be available from version 1.7.
35+
36+
5. **Note simplified registration:**<br/>
37+
We have simplified the modularization of KoliBri in version 1 and for version 2. The module `@public-ui/core` has been removed and the functionalities moved to the module `@public-ui/components`.
38+
39+
```diff
40+
- import { register } from '@public-ui/core';
41+
+ import { register } from '@public-ui/components';
42+
import { defineCustomElements } from '@public-ui/components/dist/loader';
43+
import { MyTheme } from '...';
44+
await register(MyTheme, defineCustomElements);
45+
```
46+
47+
### Breaking changes for version 2
48+
49+
You can find more information about Breaking Changes in the documentation [BREAKING_CHANGES.v2.md (EN)](https://github.com/public-ui/kolibri/blob/develop/docs/BREAKING_CHANGES.v2.md).
50+
51+
## Perform migration
52+
53+
> [!TIP]
54+
> We recommend carrying out the migration with the migration tool. This tool is able to migrate most breaking changes automatically. Further information can be found in the [Tool-Dokumentation (EN)](https://www.npmjs.com/package/@public-ui/kolibri-cli).
55+
56+
### Migration with migration tool
57+
58+
1. **Preparation:**<br/>
59+
The project is on an earlier version, all dependencies are installed, the project is executable and all changes are checked in and safely pushed.
60+
2. **Execute migration:**<br/>
61+
Execute the following command to perform the migration: `npx @public-ui/kolibri-cli migrate src`
62+
3. **Check migration:**<br/>
63+
Check the changes and run the application to make sure everything works as expected.
64+
65+
### Perform migration manually
66+
67+
1. **Preparation:**<br/>
68+
The project is on an earlier version, all dependencies are installed, the project is executable and all changes are checked in and safely pushed.
69+
2. **Perform migration:**<br/>
70+
Carry out the migration by making the breaking changes in the respective documentation.

dev/i18n/en/docusaurus-plugin-content-docs/version-1.5/90-health-state.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ import { HealthStateTable } from '@site/src/components/docs/HealthState';
1313

1414
The following table shows a wide range of information on the packages to provide an overview of their health status.
1515

16-
<HealthStateTable lang="en" version="1" />
16+
<HealthStateTable lang="en" version="2" />
1717

1818
<div
1919
style={{
Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
# Migration
2+
3+
## Introduction
4+
5+
New major versions of KoliBri are developed with the aim of simplifying maintenance and support and promoting further development.
6+
7+
This means that components, features or functionalities may be removed and technological prerequisites created to promote future innovative change.
8+
9+
- **Maintenance and care strategy:**<br/>
10+
We will always maintain the latest and previous major version of KoliBri. This means that we will fix bugs and close security gaps for these versions. For all other versions, we will no longer provide bug fixes or security updates without further notice.
11+
- **Further development:**<br/>
12+
We will always continue to develop the latest major version of KoliBri. This means that we will provide new features and functionalities for these versions. For all other versions, we will no longer provide any new features or functionalities without further ado.
13+
- **Save an executable version before migration:**<br/>
14+
Before the migration takes place, we recommend checking in an executable version so that there are no uncommitted changes to the source code to be migrated. This means that all changes can be easily tracked and checked during and after the migration.
15+
- **Migrationstool:**<br/>
16+
We provide a migration tool that generally supports the migration of source code with KoliBri. This tool is able to migrate most breaking changes automatically. Further information can be found in the [Tool-Dokumentation (EN)](https://www.npmjs.com/package/@public-ui/kolibri-cli).
17+
- **Help and feedback:**<br/>
18+
If there are any problems with the migration, we are happy to help. Please open an [Issue on GitHub](https://github.com/public-ui/kolibri/issues/new/choose).
19+
20+
## Migration from version 1 to version 2
21+
22+
### Notes on upgrading to version 2
23+
24+
1. **New features in version 2 already available from version 1.7:**<br/>
25+
Most of the new features introduced in version 2 are already available from version 1.7 and higher. This means that applications based on version 1.7 or higher may already have the necessary functions to enable a smooth migration.
26+
27+
2. **Removed properties, components and functionalities were already marked as obsolete in version 1.7 and higher:**<br/>
28+
All features, components and functionalities that were removed in version 2 were already marked as deprecated in version 1.7 and higher. So if you have regularly updated your code base, you should already be prepared to replace these elements.
29+
30+
3. **Migration from version 1.7 minimizes potential changes:**<br/>
31+
A migration from version 1.7 and higher to version 2 will probably require the least adjustments. The likelihood of incompatibilities is low, as most changes and removals have already been marked as obsolete in previous versions.
32+
33+
4. **Migration from version 1.4 is possible:**<br/>
34+
Although a migration from version 1.7 is recommended, it is also possible to migrate from version 1.4 to version 2. Please note, however, that this may require additional adjustments, as some of the necessary functions may only be available from version 1.7.
35+
36+
5. **Note simplified registration:**<br/>
37+
We have simplified the modularization of KoliBri in version 1 and for version 2. The module `@public-ui/core` has been removed and the functionalities moved to the module `@public-ui/components`.
38+
39+
```diff
40+
- import { register } from '@public-ui/core';
41+
+ import { register } from '@public-ui/components';
42+
import { defineCustomElements } from '@public-ui/components/dist/loader';
43+
import { MyTheme } from '...';
44+
await register(MyTheme, defineCustomElements);
45+
```
46+
47+
### Breaking changes for version 2
48+
49+
You can find more information about Breaking Changes in the documentation [BREAKING_CHANGES.v2.md (EN)](https://github.com/public-ui/kolibri/blob/develop/docs/BREAKING_CHANGES.v2.md).
50+
51+
## Perform migration
52+
53+
> [!TIP]
54+
> We recommend carrying out the migration with the migration tool. This tool is able to migrate most breaking changes automatically. Further information can be found in the [Tool-Dokumentation (EN)](https://www.npmjs.com/package/@public-ui/kolibri-cli).
55+
56+
### Migration with migration tool
57+
58+
1. **Preparation:**<br/>
59+
The project is on an earlier version, all dependencies are installed, the project is executable and all changes are checked in and safely pushed.
60+
2. **Execute migration:**<br/>
61+
Execute the following command to perform the migration: `npx @public-ui/kolibri-cli migrate src`
62+
3. **Check migration:**<br/>
63+
Check the changes and run the application to make sure everything works as expected.
64+
65+
### Perform migration manually
66+
67+
1. **Preparation:**<br/>
68+
The project is on an earlier version, all dependencies are installed, the project is executable and all changes are checked in and safely pushed.
69+
2. **Perform migration:**<br/>
70+
Carry out the migration by making the breaking changes in the respective documentation.

dev/i18n/en/docusaurus-plugin-content-docs/version-1.6/90-health-state.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ import { HealthStateTable } from '@site/src/components/docs/HealthState';
1313

1414
The following table shows a wide range of information on the packages to provide an overview of their health status.
1515

16-
<HealthStateTable lang="en" version="1" />
16+
<HealthStateTable lang="en" version="2" />
1717

1818
<div
1919
style={{
Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
# Migration
2+
3+
## Introduction
4+
5+
New major versions of KoliBri are developed with the aim of simplifying maintenance and support and promoting further development.
6+
7+
This means that components, features or functionalities may be removed and technological prerequisites created to promote future innovative change.
8+
9+
- **Maintenance and care strategy:**<br/>
10+
We will always maintain the latest and previous major version of KoliBri. This means that we will fix bugs and close security gaps for these versions. For all other versions, we will no longer provide bug fixes or security updates without further notice.
11+
- **Further development:**<br/>
12+
We will always continue to develop the latest major version of KoliBri. This means that we will provide new features and functionalities for these versions. For all other versions, we will no longer provide any new features or functionalities without further ado.
13+
- **Save an executable version before migration:**<br/>
14+
Before the migration takes place, we recommend checking in an executable version so that there are no uncommitted changes to the source code to be migrated. This means that all changes can be easily tracked and checked during and after the migration.
15+
- **Migrationstool:**<br/>
16+
We provide a migration tool that generally supports the migration of source code with KoliBri. This tool is able to migrate most breaking changes automatically. Further information can be found in the [Tool-Dokumentation (EN)](https://www.npmjs.com/package/@public-ui/kolibri-cli).
17+
- **Help and feedback:**<br/>
18+
If there are any problems with the migration, we are happy to help. Please open an [Issue on GitHub](https://github.com/public-ui/kolibri/issues/new/choose).
19+
20+
## Migration from version 1 to version 2
21+
22+
### Notes on upgrading to version 2
23+
24+
1. **New features in version 2 already available from version 1.7:**<br/>
25+
Most of the new features introduced in version 2 are already available from version 1.7 and higher. This means that applications based on version 1.7 or higher may already have the necessary functions to enable a smooth migration.
26+
27+
2. **Removed properties, components and functionalities were already marked as obsolete in version 1.7 and higher:**<br/>
28+
All features, components and functionalities that were removed in version 2 were already marked as deprecated in version 1.7 and higher. So if you have regularly updated your code base, you should already be prepared to replace these elements.
29+
30+
3. **Migration from version 1.7 minimizes potential changes:**<br/>
31+
A migration from version 1.7 and higher to version 2 will probably require the least adjustments. The likelihood of incompatibilities is low, as most changes and removals have already been marked as obsolete in previous versions.
32+
33+
4. **Migration from version 1.4 is possible:**<br/>
34+
Although a migration from version 1.7 is recommended, it is also possible to migrate from version 1.4 to version 2. Please note, however, that this may require additional adjustments, as some of the necessary functions may only be available from version 1.7.
35+
36+
5. **Note simplified registration:**<br/>
37+
We have simplified the modularization of KoliBri in version 1 and for version 2. The module `@public-ui/core` has been removed and the functionalities moved to the module `@public-ui/components`.
38+
39+
```diff
40+
- import { register } from '@public-ui/core';
41+
+ import { register } from '@public-ui/components';
42+
import { defineCustomElements } from '@public-ui/components/dist/loader';
43+
import { MyTheme } from '...';
44+
await register(MyTheme, defineCustomElements);
45+
```
46+
47+
### Breaking changes for version 2
48+
49+
You can find more information about Breaking Changes in the documentation [BREAKING_CHANGES.v2.md (EN)](https://github.com/public-ui/kolibri/blob/develop/docs/BREAKING_CHANGES.v2.md).
50+
51+
## Perform migration
52+
53+
> [!TIP]
54+
> We recommend carrying out the migration with the migration tool. This tool is able to migrate most breaking changes automatically. Further information can be found in the [Tool-Dokumentation (EN)](https://www.npmjs.com/package/@public-ui/kolibri-cli).
55+
56+
### Migration with migration tool
57+
58+
1. **Preparation:**<br/>
59+
The project is on an earlier version, all dependencies are installed, the project is executable and all changes are checked in and safely pushed.
60+
2. **Execute migration:**<br/>
61+
Execute the following command to perform the migration: `npx @public-ui/kolibri-cli migrate src`
62+
3. **Check migration:**<br/>
63+
Check the changes and run the application to make sure everything works as expected.
64+
65+
### Perform migration manually
66+
67+
1. **Preparation:**<br/>
68+
The project is on an earlier version, all dependencies are installed, the project is executable and all changes are checked in and safely pushed.
69+
2. **Perform migration:**<br/>
70+
Carry out the migration by making the breaking changes in the respective documentation.

dev/i18n/en/docusaurus-plugin-content-docs/version-1.7/90-health-state.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ import { HealthStateTable } from '@site/src/components/docs/HealthState';
1313

1414
The following table shows a wide range of information on the packages to provide an overview of their health status.
1515

16-
<HealthStateTable lang="en" version="1" />
16+
<HealthStateTable lang="en" version="2" />
1717

1818
<div
1919
style={{

0 commit comments

Comments
 (0)