Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve Mixins page #285

Open
wants to merge 1 commit into
base: master
from
Open

Improve Mixins page #285

wants to merge 1 commit into from

Conversation

@CyberAP
Copy link
Contributor

CyberAP commented Jul 20, 2020

State that:

  1. Mixins are a simple way to reuse component logic, rather than a flexible way to do it. The term flexible goes into conflict with the last chapter of the page, which describes that mixins are in fact inflexible.
  2. Add a section title for Precautions.

Note

Thanks for your interest in submitting a PR! At this time, because the docs are in beta, the team is currently in the midst of changes and we are not ready for additional contributions yet.

To bring your issue to the team's attention though, we would recommend creating an issue and we'll get to it when we can.

Thanks for your understanding!

State that:

1. Mixins are a __simple__ way to reuse component logic, rather than a flexible way to do it. The term __flexible__ goes into conflict with the last chapter of the page, which describes that mixins are in fact inflexible.
2. Add a section title for Precautions.
Copy link
Member

sdras left a comment

Thanks for this! Overall, agreed on the sentiment for the PR, just a small note on what to change.

@@ -2,7 +2,7 @@

## Basics

Mixins are a flexible way to distribute reusable functionalities for Vue components. A mixin object can contain any component options. When a component uses a mixin, all options in the mixin will be "mixed" into the component's own options.
Mixins are a simple way to distribute reusable functionalities for Vue components. A mixin object can contain any component options. When a component uses a mixin, all options in the mixin will be "mixed" into the component's own options.

This comment has been minimized.

@sdras

sdras Jul 20, 2020

Member

This is a good point, however we avoid the use of words like "simple" as they can be hostile to people learning (see our writing guide for more info). It might be worth just taking out the qualifier altogether here.

This comment has been minimized.

@CyberAP

CyberAP Jul 20, 2020

Author Contributor
Suggested change
Mixins are a simple way to distribute reusable functionalities for Vue components. A mixin object can contain any component options. When a component uses a mixin, all options in the mixin will be "mixed" into the component's own options.
Mixins distribute reusable functionalities for Vue components. A mixin object can contain any component options. When a component uses a mixin, all options in the mixin will be "mixed" into the component's own options.

What do you think about this change?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked issues

Successfully merging this pull request may close these issues.

None yet

2 participants
You can’t perform that action at this time.