Add note about SFC's everywhere string templates are used #1281
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description of Problem
Although SFC's are used in most Vue projects, they're barely talked about in the documentation. Most examples use string templates or a slightly ambiguous HTML+JS format, leading to inconsistency and confusion for new users.
When I first learned Vue this was one of the main things that confused me. When I had to teach people Vue last summer they had the same experience, so I figured I'd finally do something about it.
Proposed Solution
Because SFC's are so widely used I'd love to refactor all examples to use them, but I this will probably cause more confusion than it saves.
Instead I propose to copy the info note on the Component Basics page to all pages that use string-templates.
Additional Information
Please review each section critically, there's a good chance some should be shifted or even removed.
Notable omissions
This section seems to be unfinished.
I have never used async components, so I have no idea if nor how this example would translate to SFC's.
Although this section doesn't use string-templates, I feel like it might be good to mention SFC's here as well.