LearnNewsExamplesServices
Frontmatter
id7141
titleEnhance Learning Content
stateClosed
labels
enhancement
assigneestobiu
createdAtJul 31, 2025, 12:50 PM
updatedAtAug 2, 2025, 3:06 PM
githubUrlhttps://github.com/neomjs/neo/issues/7141
authortobiu
commentsCount1
parentIssue7130
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtAug 2, 2025, 3:06 PM

Enhance Learning Content

Closed v10.3.0 enhancement
tobiu
tobiu commented on Jul 31, 2025, 12:50 PM

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 assigned to @tobiu on Jul 31, 2025, 12:50 PM
tobiu added the enhancement label on Jul 31, 2025, 12:50 PM
tobiu added parent issue #7130 on Jul 31, 2025, 12:50 PM
tobiu closed this issue on Aug 2, 2025, 3:06 PM