diff options
author | Marcel Amirault <mamirault@gitlab.com> | 2019-07-24 16:10:06 +0300 |
---|---|---|
committer | Marcia Ramos <marcia@gitlab.com> | 2019-07-24 16:10:06 +0300 |
commit | 74a34e8b7bd3019b63eeae58abc7185c122bc528 (patch) | |
tree | 217da97f9143b588fcd71c8cef37c30e7eb9a1c9 /doc/development/new_fe_guide | |
parent | 0ef53789ea0f63598adf1377bd87c1944fd2ecd0 (diff) |
Clean up headers in markdown
Some markdown headers needed tweaking to adhere
to standards, including blank lines above and below,
only one space after hash, first header should be
h1, and only one h1 per doc
Diffstat (limited to 'doc/development/new_fe_guide')
-rw-r--r-- | doc/development/new_fe_guide/development/accessibility.md | 5 | ||||
-rw-r--r-- | doc/development/new_fe_guide/style/index.md | 2 |
2 files changed, 6 insertions, 1 deletions
diff --git a/doc/development/new_fe_guide/development/accessibility.md b/doc/development/new_fe_guide/development/accessibility.md index 81a29170129..ae5c4c6a6cc 100644 --- a/doc/development/new_fe_guide/development/accessibility.md +++ b/doc/development/new_fe_guide/development/accessibility.md @@ -1,17 +1,21 @@ # Accessiblity + Using semantic HTML plays a key role when it comes to accessibility. ## Accessible Rich Internet Applications - ARIA + WAI-ARIA, the Accessible Rich Internet Applications specification, defines a way to make Web content and Web applications more accessible to people with disabilities. > Note: It is [recommended][using-aria] to use semantic elements as the primary method to achieve accessibility rather than adding aria attributes. Adding aria attributes should be seen as a secondary method for creating accessible elements. ### Role + The `role` attribute describes the role the element plays in the context of the document. Check the list of WAI-ARIA roles [here][roles] ## Icons + When using icons or images that aren't absolutely needed to understand the context, we should use `aria-hidden="true"`. On the other hand, if an icon is crucial to understand the context we should do one of the following: @@ -20,6 +24,7 @@ On the other hand, if an icon is crucial to understand the context we should do 1. Use `aria-labelledby` to point to an element that contains the explanation for that icon ## Form inputs + In forms we should use the `for` attribute in the label statement: ``` diff --git a/doc/development/new_fe_guide/style/index.md b/doc/development/new_fe_guide/style/index.md index 335d9e66240..f073dc56f1f 100644 --- a/doc/development/new_fe_guide/style/index.md +++ b/doc/development/new_fe_guide/style/index.md @@ -8,7 +8,7 @@ ## [Vue style guide](vue.md) -# Tooling +## Tooling ## [Prettier](prettier.md) |