[#115] Add documentation files

changelog.md

@@ -16,12 +16,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- \[Demo\] Add banner component ([#115](https://github.com/Orange-OpenSource/ods-android/issues/115))
 - \[Lib\] Add label, current value and icon parameters to `OdsLinearProgressIndicator` component to display text and/or icon above the indicator, and the current value below if necessary ([#362](https://github.com/Orange-OpenSource/ods-android/issues/362))
 - \[Lib\] Add label parameter to `OdsCircularProgressIndicator` component to display a text below the indicator ([#362](https://github.com/Orange-OpenSource/ods-android/issues/362))
-
-### Changed
-
 - \[Lib\] Rename `OdsTitleFirstCard` and `OdsImageFirstCard` respectively into `OdsVerticalHeaderFirstCard` and `OdsVerticalImageFirstCard` ([#432](https://github.com/Orange-OpenSource/ods-android/issues/432))
+- \[Lib\] Add `OdsBanner` component ([#115](https://github.com/Orange-OpenSource/ods-android/issues/115))
 
 ### Fixed
 

docs/_data/data_menu.yml

@@ -17,6 +17,8 @@ toc2:
         url: /components/AppBarsBottom_docs
       - page: "App bars: top"
         url: /components/AppBarsTop_docs
+      - page: Banners
+        url: /components/Banners_docs
       - page: Buttons
         url: /components/Buttons_docs
       - page: Cards

docs/components/Banners.md

@@ -0,0 +1,42 @@
+---
+layout: detail
+title: Banners
+description: Banners displays an important message which requires an action to be dismissed.
+---
+
+A banner displays an important, succinct message, and provides actions for users to address (or dismiss the banner).
+It requires a user action to be dismissed.
+
+Banners should be displayed at the top of the screen, below a top app bar. They’re persistent and nonmodal, allowing the user to either ignore them or interact with them at any time.
+Only one banner should be shown at a time
+
+---
+
+**Page Summary**
+
+* [Specifications references](#specifications-references)
+* [Accessibility](#accessibility)
+* [Implementation](#implementation)
+* [Component specific tokens](#component-specific-tokens)
+
+---
+
+## Specifications references
+
+- [Design System Manager - Banners](https://system.design.orange.com/0c1af118d/p/19a040-banners/b/497b77)
+- [Material Design - Snackbars](https://m2.material.io/components/banners)
+- Technical documentation soon available
+
+## Accessibility
+
+Please follow [accessibility criteria for development](https://a11y-guidelines.orange.com/en/mobile/android/development/)
+
+Users should be able to use the left phone buttons to interact with the banner.
+The user should be able to hear the current state of the banner at all times.
+Recommendation is available at the Orange Accessibility site
+
+## Implementation
+
+## Component specific tokens
+
+_Soon available_

docs/components/Banners_docs.md

@@ -0,0 +1,4 @@
+---
+layout: main
+content_page: Banners.md
+---