{{render}} helper not documented in Ember Guides#402
{{render}} helper not documented in Ember Guides#402stefanpenner merged 3 commits intoemberjs:masterfrom
Conversation
|
I am happy to do this if someone wants to assign me. It looks like partial is also not documented in the guide. Given that, I was thinking of adding a "ways to render stuff" page under Templates that covers at least partial and render. |
Huge thanks to darthdeus, author of this post: http://darthdeus.github.com/blog/2013/02/10/render-control-partial-view/
|
I put a pull request on this issue. Huge thanks to darthdeus, author of this post: http://darthdeus.github.com/blog/2013/02/10/render-control-partial-view/ This is just a first cut. I figured it's better for the guides to discuss these helpers so people know about them, even if we do want to change or enhance what's here. Happy to make any changes. |
|
this is looking good, let me know when its ready. |
I made some of the changes recommended by fivetanley.
I added some more example code. I hesitate to add too much, as at some point it turns from a guide into an example app.
Added some more notes about {{render}}, including a brief comparison of {{outlet}} and {{render}}, which I hope is not confusing.
Added a comparison table of the three main rendering helpers.
|
Made some changes, listed in the commit msg. Tried to use my judgement on a couple things, but I'm happy to change anything. Trying to strike the right balance between complete and overkill. |
|
Also, I don't know what your best practice is regarding squashing commits when it's time to merge. Happy to move my commit history around when the time comes. |
|
Can we brainstorm some names other than "Rendering Helpers"? To me, I read this as "how helpers are rendered" and not "helpers for rendering". Maybe something like "Including Templates"? |
|
Agreed on the name. "Including Templates" is reasonable to me. My only concern would be that {{render}} doesn't just include a template. But I have no strong opinions on the title. I'll think for a bit and see if I come up with anything better. |
|
Title Suggestion: Rendering with Helpers |
|
"Rendering with Helpers" sounds like a good name. Nice work on this @mharris717, and props to @darthdeus for the post that inspired this pull. FWIW I've spent a couple days trying to figure out how to do what's in this pull before just discovering it now. Considering how conventional the functionality is, it would be good for the community to see this @ /guides sooner than later. 😄 |
|
👍 on getting the title updated and merged ASAP |
{{render}} helper not documented in Ember Guides
|
this will go live shortly. |
|
Awesome. If you have something else in the guides you've been looking to add or update, let me know and I can take a crack at it. |
|
@mharris717 thanks! If general improvements to the guides or api is always appreciated. If you are interested, one of the big ticket items that must be championed is: #237 |
|
Sure thing, I'll take a look at #237 |
5 participants
No description provided.