Vuejs.org: Conditional Rendering starts with comparison to unrelated technology

Created on 29 Aug 2018  路  2Comments  路  Source: vuejs/vuejs.org

From: https://vuejs.org/v2/guide/conditional.html#v-if

Beginning an explanation of functionality by comparison with unrelated, possibly unfamiliar technology may lead to more mystification than it alleviates.
Direct description of the operating principle, perhaps followed by a salient comparison with a related technology to mention any distinguishing behaviour may be more helpful

Most helpful comment

Agreed. Apparently, Handlebars was much bigger and more relevant back when we started the doc, enough to be set as the de-facto example. I doubt it's still the case now :)

All 2 comments

I believe that the comparison makes any sense in this case, since many new users come from templating systems based on handlebars. But I agree that the order matters here, and the comparison could come after the explanation of Vue way like @electric-skeptic suggested.

Agreed. Apparently, Handlebars was much bigger and more relevant back when we started the doc, enough to be set as the de-facto example. I doubt it's still the case now :)

Was this page helpful?
0 / 5 - 0 ratings

Related issues

emileber picture emileber  路  5Comments

kciter picture kciter  路  5Comments

daymos picture daymos  路  4Comments

meetzaveri picture meetzaveri  路  4Comments

yyx990803 picture yyx990803  路  5Comments