Enhance Learning Content

[tobiu]

Description:
Create a comprehensive guide to explain the purpose and trade-offs of using HTML templates. The current syntax-only file is insufficient for developers to make an informed decision. This new content should clearly position templates as an alternative to the core JSON VDOM, aimed at developers familiar with string-based syntaxes.

Implementation Details:

• Location: Enhance the existing file: learn/guides/uibuildingblocks/HtmlTemplates.md.
• Key Points to Cover:
  • The "Why": Explain that this feature is an alternative, not a replacement, for JSON VDOM, designed to lower the barrier to entry for developers from other framework backgrounds.
  • The Trade-Offs: Clearly state that using this feature in development mode requires loading the parse5 library (~176KB), which has a performance cost compared to the zero-dependency JSON VDOM approach.
  • Positioning: Frame it as a "beginner-friendly" or "transitional" option that helps developers get started quickly, while encouraging them to explore the power and performance of the native JSON VDOM as they become more familiar with the framework.
  • Best Practices: Provide clear examples of when to use templates and when JSON VDOM might be a better choice (e.g., for highly dynamic or programmatically generated views).

[tobiu]

resolved via https://github.com/neomjs/neo/blob/dev/learn/guides/uibuildingblocks/HtmlTemplates.md