(this page was created automatically. In case of formatting issues, please visit the official Wiki Page)

Page Template

This page will give a systematic guide on the structure and required content of component-pages in this Wiki. Furthermore, it will outline rules on the formatting of text and images.

...

• Tokens: a table of all usable tokens and a short description of their effect
• Structure & Layout: measurements, spacing, adaptive layout variation
• Styling: color, custom measurements
• Actions & Variants: interaction, transitions, variants
• Testing: automated testing
• Data Source: requirements, implimentation

Not every component needs every section. Conversely, a new section can be created if necessary. Each section can include subsections (using Headings (h4) for clarity) if plausible.

...

1. Sentences should be short and use easy language.
2. Repetition of information should be avoided. A detailed description should exist only once and further mentions should be short and relevant to the situation.
3. A listing of information during a paragraph should use bullet points instead of text.
4. Information should always be accompanied by a picture visualizing the information.
5. An Image should be labeled if they give information that is not described in the text accompanying it.

Tags

...

The Documentation has 4 types of tags: draft, new, oldupdated, updated.caution.

Image Added

Syntax:

---
title: 
note: 
tags:
- (place the tag name written in lowercase letters here)
--- 

Draft

A page with this tag has content that is actively in development or unfinished. Therefor the published arcticle article is currently unfinished. Following szenarios scenarios might apply:

• The item of the page, for example a component, is currently in its initial development.
• Information in an article, for example a pattern, is being reworked and thereby subject to change.
• A page in the wiki is being created, and the published version is not the desired final state.

...

After a pages first creation it recieves receives the tag "new". This tag vanishes after two months of being present.

Updated

After recieving receiving significant changes in the content, a page recieves receives the "updated" tag. This tag vanishes after one month. Significent Significant pages include but are not limited to:

• Addition - New information is added to the page. For example, a component has a new feature.
• Deletion - Outdated or wrong information gets removed from a page.
• Alteration - Information on the page is fundamentally changed. For example, a pattern is restructured. This does not include purely editorial changes.

...

Caution

If a page contains critical content, it recieves receives the "Cautioncaution"-tag. This applies to both the text and the information behind it. Examples for critical information:

• A page shows outdated information that might mislead the user.
• The subject of the page, for example a component, is not working as designed and needs to be changed.
• Infomration Information on a page is not verified.
• Multiple users have reported problems with this page.

A note at the start of the page might give further information on the critical content.

Alerts

Alerts are colored boxes that can be placed at the beginning of a page, under der h1 heading. They give general information about the following article. There are two types of notes:

Note

An article might have meta information that is critical to the understanding of the page. For example, there are two pages called Boardlet. A note at the beginning of a page informs them what page they are on, what the page contains, and gives a link to the other page.

Syntax:

> [!NOTE]
> Text inside the alert.

Example:

[!NOTE] This article is about the Boardlet Pattern. For more information about the boardlet component in the App Composer, please visit this page.

Warning

The "caution" or "draft" tags might need further explanation. This explanation is placed in an alert at the beginning of the article. This alert describes

• Caution - The nature of the critical content in the page.
• Draft - The kind of draft (from scratch or changes) and what parts are being changed.

Syntax:

> [!WARNING]
> Text inside the alert.

Example:

[!WARNING] This component might not work as intended. Please use with caution.