Skip to content

Commit 4d685f3

Browse files
ilhan007ilhan007
authored
docs: update structure and titles (SAP#9338)
* docs: update structure and titles * chore: update * chore: fix links to migration guide
1 parent 43d5720 commit 4d685f3

34 files changed

+97
-249
lines changed

‎README.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
1-
![UI5 icon](/docs/images/UI5_logo_wide.png)
1+
# ![UI5 icon](https://raw.githubusercontent.com/SAP/ui5-webcomponents/main/docs/images/UI5_logo_water.png)UI5 Web Components
22

3-
# UI5 Web Components
43
[![CI](https://github.com/SAP/ui5-webcomponents/actions/workflows/test.yaml/badge.svg)](https://github.com/SAP/ui5-webcomponents/actions/workflows/test.yaml)
54
[![npm Package Version](https://badge.fury.io/js/%40ui5%2Fwebcomponents.svg)](https://www.npmjs.com/package/@ui5/webcomponents)
65
[![REUSE status](https://api.reuse.software/badge/github.com/SAP/ui5-webcomponents)](https://api.reuse.software/info/github.com/SAP/ui5-webcomponents)

‎docs/Release Management.md renamed to ‎docs/08-Releases.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Release Management
1+
# Releases
22

33
The article describes the release process management of UI5 Web Components.
44

‎docs/FAQ.md renamed to ‎docs/09-FAQ.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,7 @@
1+
---
2+
sidebar_label: FAQ
3+
---
4+
15
# Frequently Asked Questions
26

37
**Q: How can I play with UI5 Web Components easily?**

‎docs/4-frameworks/01-React.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Get Started with UI5 Web Components & React
1+
# UI5 Web Components & React
22

33
In this tutorial, you will learn how to add UI5 Web Components to your application. You can add UI5 Web Components both to new React applications and to already existing ones.
44

‎docs/4-frameworks/02-Angular.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Get Started with UI5 Web Components & Angular
1+
# UI5 Web Components & Angular
22

33
In this tutorial, you will learn how to use `UI5 Web Components` in an Angular application. In the second part, we will introduce `UI5 Web Components for Angular` - wrapper library for UI5 Web Components, improving their integration with Angular.
44

‎docs/4-frameworks/03-Vue.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Get Started with UI5 Web Components & Vue.js
1+
# UI5 Web Components & Vue.js
22

33
In this tutorial you will learn how to add UI5 Web Components to your application. You can add UI5 Web Components both to new Vue.js applications and to already existing ones.
44

‎docs/5-development/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
1-
# UI5 Web Components Custom Development
1+
# UI5 Web Components Development
22

33
This section explains how to create your own custom UI5 Web Components packages and develop your own UI5 Web Components.

‎docs/6-contributing/01-development-workflow.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# General Development Workflow
2-
This document aims to explain the steps component developers would have to perform
3-
on daily basis from forking the project to merging a change, emphasising on the Github workflow.
1+
# Development Workflow
2+
3+
This article explains the daily development workflow for component developers: from forking to merging changes.
44

55

66
## 1. Fork the UI5 Web Components repository.

‎docs/6-contributing/02-conventions-and-guidelines.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
1-
# Development Conventions and Guidelines
1+
# Conventions and Guidelines
2+
23
## JavaScript Coding Guidelines
34
We enforce code style rules using [ESLint](https://eslint.org). Execute `npm run lint` to check your code for style issues.
45
You may also find an ESLint integration for your favorite IDE [here](https://eslint.org/docs/user-guide/integrations).

‎docs/DoD.md renamed to ‎docs/6-contributing/03-DoD.md

File renamed without changes.

‎docs/6-contributing/03-website.md

Lines changed: 0 additions & 17 deletions
This file was deleted.

‎docs/6-contributing/04-website-samples.md renamed to ‎docs/6-contributing/04-website.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,22 @@
1+
# Running the Website
2+
3+
The UI5 Web Components Website app is the entry point of the UI5 Web Components project.
4+
The app includes documentation, API reference and samples for all the available web components.
5+
6+
The website can be run locally to test your changes and samples.
7+
In order to do so, you have to follow the steps below:
8+
9+
In your terminal, run the following commands:
10+
11+
```bash
12+
yarn
13+
yarn start:website
14+
```
15+
16+
This will build all the necessary assets and will start local server on your machine
17+
and finally open the website in your browser.
18+
19+
120
# Creating Website Samples
221

322
The website app is developed in its own package `packages/website`. Components features or states are demonstrated via samples meant for consumers.

‎docs/6-contributing/05-storybook.md

Lines changed: 0 additions & 20 deletions
This file was deleted.

‎docs/6-contributing/06-storybook-samples.md

Lines changed: 0 additions & 144 deletions
This file was deleted.

‎docs/6-contributing/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
1-
# Contributing to the UI5 Web Components Project
1+
# Contributing
22

3-
Contributions are welcome!
3+
Contributions to the UI5 Web Components project are welcome!
44

55
This section explains our conventions, how to run the project locally, and more.

‎docs/Migrating to version 2.0 guide.md renamed to ‎docs/7-migration-guides/01-to-version-2.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,10 @@
1-
# UI5 Web Components 2.0 migration guide
1+
---
2+
sidebar_label: To UI5 Web Components 2.0
3+
---
24

3-
This documentation will assist you in seamlessly transitioning from UI5 Web Components v1.x to the latest version, UI5 Web Components 2.0.
5+
# Migration to UI5 Web Components 2.0
6+
7+
This guide will assist you in seamlessly transitioning from UI5 Web Components version 1.x to UI5 Web Components 2.0.
48

59
## @ui5/webcomponents-base
610

‎docs/7-migration-guides/README.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Migration Guides
2+
3+
UI5 Web Components versioning is based on [Semantic Versioning](https://semver.org/).
4+
5+
Breaking changes are only released on major version upgrades, and thoroughly documented in the following upgrade guides.

‎docs/README.md

Lines changed: 36 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,38 @@
1-
# UI5 Web Components Documentation
1+
# Introduction
22

3-
Welcome to the UI5 Web Components documentation!
3+
The UI5 Web Components project offers a rich set of enterprise-grade, reusable UI elements built on top of the [Web Components](https://developer.mozilla.org/en-US/docs/Web/API/Web_components) standards.
4+
With UI5 Web Components, developers can leverage a powerful, flexible, and future-proof toolkit to create anything from **static web sites** to **complex web applications**.
45

5-
Browse the directories to find the needed content, or read the same docs on the [official site](https://sap.github.io/ui5-webcomponents/play)
6+
7+
## Key Features of UI5 Web Components
8+
9+
- Enterprise-Grade: A comprehensive collection of reusable UI elements that adhere to enterprise standards - accessibility, themeability, i18n and more.
10+
11+
- Framework Agnostic: Fully compatible with any current or future web development frameworks such as React, Angular, and Vue, allowing seamless integration into any tech stack.
12+
13+
- Elegant: Being custom HTML elements, they hide implementation complexity behind a single HTML tag, making them easily usable with the standard DOM APIs.
14+
15+
- Consistent User Experience: Implementing the [SAP Fiori design](https://experience.sap.com/fiori-design/) and adhering to the [SAP Fiori Design Guidelines](https://experience.sap.com/fiori-design-web/) ensures a consistent and intuitive user experience across all applications.
16+
17+
- Open Source: UI5 Web Components is an open-source project available to the general public, inviting developers from all backgrounds to contribute and benefit.
18+
19+
- SAP Backing: Developed and maintained by [SAP](https://sap.com) as part of the [UI5](https://openui5.org/) product family, guaranteeing ongoing support and integration with SAP's ecosystem.
20+
21+
22+
## Ecosystem
23+
24+
UI5 Web Components are complemented by a range of related projects that enhance the development experience even further. These projects build on top of the core UI5 Web Components, providing additional functionalities and integrations tailored to specific frameworks and use cases.
25+
26+
### UI5 Web Components for React
27+
28+
[UI5 Web Components for React](https://github.com/SAP/ui5-webcomponents-react) is a wrapper implementation around UI5 Web Components which makes using them in React even more comfortable. The current version of React (`react 18`) has some shortcomings when it comes to handling Custom Elements, namely the binding of `boolean` attributes as well as adding event listeners to custom event names like `selection-change`. With the help of UI5 Web Components for React, you can use the UI5 Web Components in React as if they were native React components. In addition to that, this library is also offering some complex layout components built on top of UI5 Web Components as well as Charting Components.
29+
30+
**Note:** [React 19](https://react.dev/blog/2024/04/25/react-19) promises to fill all gaps in the web coponents support - the binding of `boolean` attributes and subscribing to custom events.
31+
32+
### UI5 Web Components for Angular
33+
34+
[UI5 Web Components for Angular](https://github.com/SAP/ui5-webcomponents-ngx) is a wrapper implementation around UI5 Web Components which to make it work with Angular without needing to use the `CUSTOM_ELEMENTS_SCHEMA` or `NO_ERRORS_SCHEMA` schemas.
35+
Moreover, all Angular-specific features, such as two-way data binding and Angular Form support, work out of the box.
36+
37+
38+
**Continue reading to start using UI5 Web Components right away!**

‎docs/images/UI5_logo_water.png

2.96 KB
Loading

‎docs/images/UI5_logo_wide.png

-65.4 KB
Binary file not shown.

‎packages/ai/README.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,4 @@
1-
![UI5 icon](https://raw.githubusercontent.com/SAP/ui5-webcomponents/main/docs/images/UI5_logo_wide.png)
2-
3-
4-
# UI5 Web Components - AI
1+
# ![UI5 icon](https://raw.githubusercontent.com/SAP/ui5-webcomponents/main/docs/images/UI5_logo_water.png)UI5 Web Components - AI
52

63
[![npm Package Version](https://badge.fury.io/js/%40ui5%2Fwebcomponents.svg)](https://www.npmjs.com/package/@ui5/webcomponents)
74

‎packages/base/README.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,4 @@
1-
![UI5 icon](https://raw.githubusercontent.com/SAP/ui5-webcomponents/main/docs/images/UI5_logo_wide.png)
2-
3-
4-
# UI5 Web Components - Base
1+
# ![UI5 icon](https://raw.githubusercontent.com/SAP/ui5-webcomponents/main/docs/images/UI5_logo_water.png)UI5 Web Components - Base
52

63
[![npm Package Version](https://badge.fury.io/js/%40ui5%2Fwebcomponents.svg)](https://www.npmjs.com/package/@ui5/webcomponents)
74

‎packages/compat/README.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,4 @@
1-
![UI5 icon](https://raw.githubusercontent.com/SAP/ui5-webcomponents/main/docs/images/UI5_logo_wide.png)
2-
3-
4-
# UI5 Web Components - Compatibility
1+
# ![UI5 icon](https://raw.githubusercontent.com/SAP/ui5-webcomponents/main/docs/images/UI5_logo_water.png)UI5 Web Components - Compatibility
52

63
[![npm Package Version](https://badge.fury.io/js/%40ui5%2Fwebcomponents.svg)](https://www.npmjs.com/package/@ui5/webcomponents)
74

‎packages/create-package/README.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,4 @@
1-
![UI5 icon](https://raw.githubusercontent.com/SAP/ui5-webcomponents/main/docs/images/UI5_logo_wide.png)
2-
3-
4-
# UI5 Web Components - Create Package
1+
# ![UI5 icon](https://raw.githubusercontent.com/SAP/ui5-webcomponents/main/docs/images/UI5_logo_water.png)UI5 Web Components - Create Package
52

63
[![npm Package Version](https://badge.fury.io/js/%40ui5%2Fwebcomponents.svg)](https://www.npmjs.com/package/@ui5/webcomponents)
74

‎packages/fiori/README.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,4 @@
1-
![UI5 icon](https://raw.githubusercontent.com/SAP/ui5-webcomponents/main/docs/images/UI5_logo_wide.png)
2-
3-
4-
# UI5 Web Components - Fiori
1+
# ![UI5 icon](https://raw.githubusercontent.com/SAP/ui5-webcomponents/main/docs/images/UI5_logo_water.png)UI5 Web Components - Fiori
52

63
[![npm Package Version](https://badge.fury.io/js/%40ui5%2Fwebcomponents.svg)](https://www.npmjs.com/package/@ui5/webcomponents)
74

‎packages/icons-business-suite/README.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,4 @@
1-
![UI5 icon](https://raw.githubusercontent.com/SAP/ui5-webcomponents/main/docs/images/UI5_logo_wide.png)
2-
3-
4-
# UI5 Web Components - SAP Business Suite Icons
1+
# ![UI5 icon](https://raw.githubusercontent.com/SAP/ui5-webcomponents/main/docs/images/UI5_logo_water.png)UI5 Web Components - SAP Business Suite Icons
52

63
[![npm Package Version](https://badge.fury.io/js/%40ui5%2Fwebcomponents.svg)](https://www.npmjs.com/package/@ui5/webcomponents)
74

0 commit comments

Comments
 (0)