VNode is used in the Guide before it is defined

[cxw42]

Brand-new to Vue, and I'm reading the Guide front to back. The term VNode is used in the Custom Directives page. However, it is not defined until later in the Guide, in the Render Functions & JSX page. I see that was mentioned in #319 (comment).

Would someone who actually knows Vue :) be willing to update the Guide so that VNode is not used without explanation on the Custom Directives page? I don't claim to know what would be the best way to accomplish that :) . Thank you!

[phanan]

Would a link e.g. VNode suffice?

[cxw42]

It would certainly be better than nothing :) . Again, as a rank newbie, I think I would benefit from both the link and a brief intro at the top of the section. How about something like the below? (I'm happy to submit a PR if you wish.)

Hooks

A directive definition object can provide several hook functions (all optional). The hooks fall at various points along the path from a template or render function, through Virtual DOM nodes ("VNodes"), to real DOM nodes that are presented in the browser. We'll cover VNodes in more detail later, when we discuss render functions. For now, all you need to know is that Vue processes the Virtual DOM, then updates the real DOM based on the Virtual DOM.

• bind...

[phanan]

I would actually prefer a p.tip after the update hook (where we first mention the term), which may simply say

We'll cover VNodes in more details later, when we discuss [render functions](link).

[cxw42]

You're the expert, so I defer to your judgment. Thanks!

[cxw42]

@phanan Have you had a chance to look at #1855? I just rebased it onto the latest master. Thanks!

[phanan]

@cxw42 Indeed, this slips my watch :) Thanks!