diff --git a/src/coc/index.md b/src/coc/index.md index fd53230a08..29a950b967 100644 --- a/src/coc/index.md +++ b/src/coc/index.md @@ -2,7 +2,7 @@ ## Our Pledge -In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, political party, or sexual identity and orientation. Note, however, that religion, political party, or other ideological affiliation provide no exemptions for the behavior we outline as unacceptable in this Code of Conduct. +In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to make participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, political party, or sexual identity and orientation. Note, however, that religion, political party, or other ideological affiliation provide no exemptions for the behavior we outline as unacceptable in this Code of Conduct. ## Our Standards diff --git a/src/community/join.md b/src/community/join.md index b78cbf359c..bb4ef014b4 100644 --- a/src/community/join.md +++ b/src/community/join.md @@ -41,7 +41,7 @@ After that, you'll be ready to contribute to Vue's core repositories: Apart from answering questions and sharing resources in the forum and chat, there are a few other less obvious ways to share and expand what you know: - **Develop learning materials.** It's often said that the best way to learn is to teach. If there's something interesting you're doing with Vue, strengthen your expertise by writing a blog post, developing a workshop, or even publishing a gist that you share on social media. -- **Watch a repo you care about.** This will send you notifications whenever there's activity in that repository, giving you insider knowledge about ongoing discussions and upcoming features. It's a fantastic way to build expertise so that you're eventually able to help address issues and pull requests. +- **Watch a repo you care about.** This will send you notifications whenever there's an activity in that repository, giving you insider knowledge about ongoing discussions and upcoming features. It's a fantastic way to build expertise so that you're eventually able to help address issues and pull requests. ### Translate Docs diff --git a/src/cookbook/debugging-in-vscode.md b/src/cookbook/debugging-in-vscode.md index 2694ce379f..f43f789a77 100644 --- a/src/cookbook/debugging-in-vscode.md +++ b/src/cookbook/debugging-in-vscode.md @@ -1,6 +1,6 @@ # Debugging in VS Code -Every application reaches a point where it's necessary to understand failures, small to large. In this recipe, we explore a few workflows for VS Code users who would like to debug their application in the browser. +Every application reaches a point where it's necessary to understand failures, small to large. In this recipe, we explore a few workflows for VS Code users who would like to debug their applications in the browser. This recipe shows how to debug [Vue CLI](https://github.com/vuejs/vue-cli) applications in VS Code as they run in the browser. diff --git a/src/cookbook/editable-svg-icons.md b/src/cookbook/editable-svg-icons.md index 360a076777..c0f85ce5e7 100644 --- a/src/cookbook/editable-svg-icons.md +++ b/src/cookbook/editable-svg-icons.md @@ -2,7 +2,7 @@ ## Base Example -There are many ways to create an SVG Icon System, but one method that takes advantage of Vue's capabilities is to create editable inline icons as components. Some of the advantages of this way of working is: +There are many ways to create an SVG Icon System, but one method that takes advantage of Vue's capabilities is to create editable inline icons as components. Some of the advantages of this way of working are: - They are easy to edit on the fly - They are animatable @@ -141,7 +141,7 @@ export default { } ``` -We're applying `refs` to the groups of paths we need to move, and as both sides of the scissors have to move in tandem, we'll create a function we can reuse where we'll pass in the `refs`. The use of GreenSock helps resolve animation support and `transform-origin` issues across browser. +We're applying `refs` to the groups of paths we need to move, and as both sides of the scissors have to move in tandem, we'll create a function we can reuse where we'll pass in the `refs`. The use of GreenSock helps resolve animation support and `transform-origin` issues across browsers. @@ -151,7 +151,7 @@ You can see more animated examples in the repo [here](https://github.com/sdras/v ## Additional Notes -Designers may change their minds. Product requirements change. Keeping the logic for the entire icon system in one base component means you can quickly update all of your icons and have it propagate through the whole system. Even with the use of an icon loader, some situations require you to recreate or edit every SVG to make global changes. This method can save you that time and pain. +Designers may change their minds. Product requirements change. Keeping the logic for the entire icon system in one base component means you can quickly update all of your icons and have them propagate through the whole system. Even with the use of an icon loader, some situations require you to recreate or edit every SVG to make global changes. This method can save you that time and pain. ## When To Avoid This Pattern @@ -164,4 +164,4 @@ Other tooling to help manage SVG icons includes: - [svg-sprite-loader](https://github.com/kisenka/svg-sprite-loader) - [svgo-loader](https://github.com/rpominov/svgo-loader) -These tools bundle SVGs at compile time, but make them a little harder to edit during runtime, because `` tags can have strange cross-browser issues when doing anything more complex. They also leave you with two nested `viewBox` properties and thus two coordinate systems. This makes the implementation a little more complex. +These tools bundle SVGs at time of compilation, but make them a little harder to edit during runtime, because `` tags can have strange cross-browser issues when doing anything more complex. They also leave you with two nested `viewBox` properties and thus two coordinate systems. This makes the implementation a little more complex. diff --git a/src/cookbook/index.md b/src/cookbook/index.md index 13060edb85..d384e3118a 100644 --- a/src/cookbook/index.md +++ b/src/cookbook/index.md @@ -66,7 +66,7 @@ It's extremely helpful to write a bit about this pattern, where else it would ap ### When To Avoid This Pattern -This section is not required, but heavily recommended. It won't make sense to write it for something very simple such as toggling classes based on state change, but for more advanced patterns like mixins it's vital. The answer to most questions about development is ["It depends!"](https://codepen.io/rachsmith/pen/YweZbG), this section embraces that. Here, we'll take an honest look at when the pattern is useful and when it should be avoided, or when something else makes more sense. +This section is not required but heavily recommended. It won't make sense to write it for something very simple such as toggling classes based on state change, but for more advanced patterns like mixins, it's vital. The answer to most questions about development is ["It depends!"](https://codepen.io/rachsmith/pen/YweZbG), this section embraces that. Here, we'll take an honest look at when the pattern is useful and when it should be avoided, or when something else makes more sense. ### Alternative Patterns diff --git a/src/guide/a11y-basics.md b/src/guide/a11y-basics.md index e55d2648a8..5e5e30f3cb 100644 --- a/src/guide/a11y-basics.md +++ b/src/guide/a11y-basics.md @@ -1,6 +1,6 @@ # Basics -Web accessibility (also known as a11y) refers to the practice of creating websites that can be used by anyone — be that a person with a disability, a slow connection, outdated or broken hardware or simply someone in an unfavorable environment. For example, adding subtitles to a video would help both your deaf and hard-of-hearing users and your users who are in a loud environment and can't hear their phone. Similarly, making sure your text isn't too low contrast will help both your low-vision users and your users who are trying to use their phone in bright sunlight. +Web accessibility (also known as a11y) refers to the practice of creating websites that can be used by anyone — be that a person with a disability, a slow connection, outdated or broken hardware, or simply someone in an unfavorable environment. For example, adding subtitles to a video would help both your deaf and hard-of-hearing users and your users who are in a loud environment and can't hear their phones. Similarly, making sure your text isn't too low contrast will help both your low-vision users and your users who are trying to use their phones in bright sunlight. Ready to start but aren’t sure where? @@ -8,7 +8,7 @@ Checkout the [Planning and managing web accessibility guide](https://www.w3.org/ ## Skip link -You should add a link at the top of each page that goes directly to the main content area so users can skip content that is repeated on multiple Web pages. +You should add a link at the top of each page that goes directly to the main content area so that users can skip content that was repeated on multiple Web pages. Typically this is done on the top of `App.vue` as it will be the first focusable element on all your pages: