You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

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

Patterns Template

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

Structure

Overview

Provide one to three short paragraphs that explain:

  • The primary use cases.
  • The pattern’s role in the Inspire Design ecosystem.
  • Core capabilities or behaviors.

In addition to the bullet points, the overview includes a picture showing one examplary implementation of the pattern. If different types of the pattern exist, the overview should include a table with thes types, their use case and a short description.

Anatomy

This section is image first. It includes one or more anotated images of the pattern. They should visualy showcase the structure in combination with alegend. The legend includes the propper name for the structural elements and a short description for each.

Best Practices/ Guidelines

This section explains when and how to use the pattern. It should be short and scannable, jet include the most important aspects pertaining to usage. The Guidelines described here should pertain to the pattern in general, not a specific implementation of the pattern inside a specific context. If possible, the information should always be accompanied by images.

  • Dos and Don'ts: This optional sub-section of Best Practices forms a comparison between right and wrong implementations of the pattern.
  • Accessibility: The Accessibility sub-section focuses on ways the pattern ensures accessibility. In addition, it can also explain, how the pattern has to be impleented to ensure accessibility. This section is currently optional.

[Pattern specific pages]

This is a subset of section focues on any number of features and pattern manifestations that the pattern has. Examples include:

  • Types: Any number of sub-sections explaining the manifestation of the pattern inside specific contexts and components.
  • Hierarchy: Explaining the information hierarchy inside the pattern or how the pattern fits into the hierarchy of anny given context.
  • Implementation: A step-by-step explanation on how to build the pattern inside the app composer.
  • Features: Important aspects of the features in more detail than is possible inside the Anatomy section.

These Sections can include Anatomy ot Guidelines specific to their part of the pattern.

Related Components (listing with links)

Here should e a list of all components that are affected by or a part of this pattern.

General Rules

  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.
  6. Where other patterns or components are mentioned, they should be linked.
  • No labels