handlebars-lang / handlebars-lang/handlebars.js

We need a spec

Open
#1,277 8 comments 1 reaction 0 assignees View on GitHub
Dominant language
JavaScript
Stars
18.7k
Forks
2.1k
PR merge metrics
No merged PRs in 30d

Description

Currently, the Handlebars language is defined by the behavior of this reference implementation and incompletely described by the documentation found at handlebarsjs.com. This makes it very difficult to reason about bugs like #1276. Should partials that use `{{> @partial-block}}` be invocable in the manner the bug reporter expects? Not clear.

I had a related discussion with @wycats and we came to the conclusion that we need to specify the language before we move forward with any new features.

This would be a non-trivial effort. Thoughts?

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the existing documentation at handlebarsjs.com, the behavior of the reference implementation, and bug #1276, especially the question about partials using `{{> @partial-block}}`. A complete result would define the Handlebars language sufficiently to resolve such semantic questions before new features are added.

Written by the indexing model from the issue text.

Assessment

Tech stack
handlebars, javascript
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.