search

ember-learn / cli-guides

Step-by-step guides and tutorials for using the ember-cli to create apps and addons
https://cli.emberjs.com
MIT License
25 stars 77 forks source link

Integrate FastBoot Info #108

Open rwjblue opened 5 years ago

rwjblue commented 5 years ago

I'm not 100% sure how to do this yet, but this came up on a recent FastBoot team call (thanks @mansona!) and I think its a great idea.

Can we brainstorm just how best to do this?

sdhull commented 5 years ago

Maybe there should be a top-level section (not sure what learning team calls these things) called "Deployment" and the sub-items could be "Static Deployment" and another titled "Server-Side Rendering"?

That would probably necessitate some changes to the existing "Deployment" page in the "Tutorial" section.

mansona commented 5 years ago

At the fastboot meeting today there was a bit of confusion as to what this issue was referring to so I thought I'd give some context.

This issue originally came out of the fact that I personally didn't know what the updateFastbootManifest() hook was supposed to do and there seemed to be some confusion in the wider community too (with some discussed examples of addons doing some strange things with it). I was asking for there to be some documentation written about it and was surprised that there was actually a page that went into some detail here: http://ember-fastboot.com/docs/addon-author-guide

As an addon developer I have never come across this page 🤔and it seemed to me like this information is more relevant to people that might be looking at https://cli.emberjs.com rather than ember-fastboot.com.

It makes sense that this information is relevant to both websites but we should consider one of them as the "canonical" source and direct people from the other to read that main documentation. This issue is to discuss how we expect that to look 👍

villander commented 5 years ago

I think that Fastboot/SSR must be placed on "Application & Concerns" on Ember guides, like Ember engines was added - https://guides.emberjs.com/release/applications/ember-engines/