Commit 8ee9c752 authored by Mike Jang's avatar Mike Jang Committed by Craig Norris

Replace 'here' in links in developer docs

parent 58f318e0
...@@ -15,5 +15,5 @@ You can find the Frontend Architecture experts on the [team page](https://about. ...@@ -15,5 +15,5 @@ You can find the Frontend Architecture experts on the [team page](https://about.
## Examples ## Examples
You can find documentation about the desired architecture for a new feature You can find [documentation about the desired architecture](vue.md) for a new
built with Vue.js [here](vue.md). feature built with Vue.js.
# Icons and SVG Illustrations # Icons and SVG Illustrations
We manage our own Icon and Illustration library in the [`gitlab-svgs`](https://gitlab.com/gitlab-org/gitlab-svgs) repository. We manage our own icon and illustration library in the [`gitlab-svgs`](https://gitlab.com/gitlab-org/gitlab-svgs)
This repository is published on [npm](https://www.npmjs.com/package/@gitlab/svgs) and managed as a dependency via yarn. repository. This repository is published on [npm](https://www.npmjs.com/package/@gitlab/svgs),
You can browse all available Icons and Illustrations [here](https://gitlab-org.gitlab.io/gitlab-svgs). and is managed as a dependency with yarn. You can browse all available
To upgrade to a new version run `yarn upgrade @gitlab/svgs`. [icons and illustrations](https://gitlab-org.gitlab.io/gitlab-svgs). To upgrade
to a new version run `yarn upgrade @gitlab/svgs`.
## Icons ## Icons
...@@ -21,10 +22,11 @@ To use a sprite Icon in HAML or Rails we use a specific helper function : ...@@ -21,10 +22,11 @@ To use a sprite Icon in HAML or Rails we use a specific helper function :
sprite_icon(icon_name, size: nil, css_class: '') sprite_icon(icon_name, size: nil, css_class: '')
``` ```
- **icon_name** Use the icon_name that you can find in the SVG Sprite - **icon_name**: Use the icon_name for the SVG sprite in the list of
([Overview is available here](https://gitlab-org.gitlab.io/gitlab-svgs)). ([GitLab SVGs](https://gitlab-org.gitlab.io/gitlab-svgs)).
- **size (optional)** Use one of the following sizes : 16, 24, 32, 48, 72 (this will be translated into a `s16` class) - **size (optional)**: Use one of the following sizes : 16, 24, 32, 48, 72 (this
- **css_class (optional)** If you want to add additional CSS classes will be translated into a `s16` class)
- **css_class (optional)**: If you want to add additional CSS classes.
**Example** **Example**
...@@ -66,10 +68,12 @@ export default { ...@@ -66,10 +68,12 @@ export default {
</template> </template>
``` ```
- **name** Name of the Icon in the SVG Sprite ([Overview is available here](https://gitlab-org.gitlab.io/gitlab-svgs)). - **name**: Name of the icon of the SVG sprite, as listed in the
- **size (optional)** Number value for the size which is then mapped to a specific CSS class ([GitLab SVG Previewer](https://gitlab-org.gitlab.io/gitlab-svgs)).
(Available Sizes: 8, 12, 16, 18, 24, 32, 48, 72 are mapped to `sXX` CSS classes) - **size: (optional)** Number value for the size which is then mapped to a
- **class (optional)** Additional CSS Classes to add to the SVG tag. specific CSS class (Available sizes: 8, 12, 16, 18, 24, 32, 48, 72 are mapped
to `sXX` CSS classes)
- **class (optional)**: Additional CSS classes to add to the SVG tag.
### Usage in HTML/JS ### Usage in HTML/JS
......
...@@ -101,7 +101,10 @@ Our code is automatically formatted with [Prettier](https://prettier.io) to foll ...@@ -101,7 +101,10 @@ Our code is automatically formatted with [Prettier](https://prettier.io) to foll
### Editor ### Editor
The easiest way to include prettier in your workflow is by setting up your preferred editor (all major editors are supported) accordingly. We suggest setting up prettier to run automatically when each file is saved. Find [here](https://prettier.io/docs/en/editors.html) the best way to set it up in your preferred editor. The recommended method to include Prettier in your workflow is to set up your
preferred editor (all major editors are supported) accordingly. We suggest
setting up Prettier to run when each file is saved. For instructions about using
Prettier in your preferred editor, see the [Prettier documentation](https://prettier.io/docs/en/editors.html).
Please take care that you only let Prettier format the same file types as the global Yarn script does (`.js`, `.vue`, `.graphql`, and `.scss`). In VSCode by example you can easily exclude file formats in your settings file: Please take care that you only let Prettier format the same file types as the global Yarn script does (`.js`, `.vue`, `.graphql`, and `.scss`). In VSCode by example you can easily exclude file formats in your settings file:
......
...@@ -32,8 +32,9 @@ When using Vuex at GitLab, separate these concerns into different files to impro ...@@ -32,8 +32,9 @@ When using Vuex at GitLab, separate these concerns into different files to impro
└── mutation_types.js # mutation types └── mutation_types.js # mutation types
``` ```
The following example shows an application that lists and adds users to the state. The following example shows an application that lists and adds users to the
(For a more complex example implementation take a look at the security applications store in [here](https://gitlab.com/gitlab-org/gitlab/tree/master/ee/app/assets/javascripts/vue_shared/security_reports/store)) state. (For a more complex example implementation, review the security
applications stored in this [repository](https://gitlab.com/gitlab-org/gitlab/tree/master/ee/app/assets/javascripts/vue_shared/security_reports/store)).
### `index.js` ### `index.js`
......
...@@ -12,7 +12,7 @@ WAI-ARIA (the Accessible Rich Internet Applications specification) defines a way ...@@ -12,7 +12,7 @@ WAI-ARIA (the Accessible Rich Internet Applications specification) defines a way
The `role` attribute describes the role the element plays in the context of the document. The `role` attribute describes the role the element plays in the context of the document.
Check the list of WAI-ARIA roles [here](https://www.w3.org/TR/wai-aria-1.1/#landmark_roles) Review the list of [WAI-ARIA roles](https://www.w3.org/TR/wai-aria-1.1/#landmark_roles).
## Icons ## Icons
......
...@@ -82,7 +82,8 @@ This Ruby Regex specialty can have security impact, as often regular expressions ...@@ -82,7 +82,8 @@ This Ruby Regex specialty can have security impact, as often regular expressions
#### Examples #### Examples
GitLab specific examples can be found [here](https://gitlab.com/gitlab-org/gitlab/-/issues/36029#note_251262187) and [there](https://gitlab.com/gitlab-org/gitlab/-/issues/33569). GitLab-specific examples can be found in the following [path traversal](https://gitlab.com/gitlab-org/gitlab/-/issues/36029#note_251262187)
and [open redirect](https://gitlab.com/gitlab-org/gitlab/-/issues/33569) issues.
Another example would be this fictional Ruby on Rails controller: Another example would be this fictional Ruby on Rails controller:
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment