Quest: Octane Guides MVP Tracking issue

[MelSumner]

Hello and thanks so much for helping out with the Octane Guides! Even if you don't know much about Octane or Native Classes, there's something you can help with! Here's everything you need to know to pitch in.

The "new volunteers needed" links below that are the things we need help with more than anything else. We are aiming to finish a rough draft of the Guides by March 15th. If you volunteer for an issue, please only do so if you can have a PR with at least part of the work ready the following evening after you claim the issue. To volunteer, comment in the linked issue (not here) to say that you can help. You should git branch from the octane branch of the Guides, do work in the markdown files in the guides/release directory, and when you open a PR, make it go the octane branch. If you want to learn the basics of what's different in Octane, have a read through this draft guide.

New volunteers needed:

Please check the comments on issues to see if they are already claimed. Are they all taken? Pick a different section of the guides, copy and paste the contents of one of the "JavaScript Code Blocks to use Class Syntax" issues for a section that's not in this list, open an issue, and put at the top that you're helping with it! You can grab just one page, or a whole section. It's up to you!

• create a new section, services - requires no Octane knowledge
• Change Quickstart JavaScript Code Blocks to use Class Syntax - good for someone who wants to learn class syntax, since there are a small # of code blocks
• Change Writing Helpers JavaScript code blocks to use Class Syntax - good for someone who wants to learn class syntax, since there are a small # of code blocks
• Change Tutorial examples to use Class Syntax - helpful to know Native Classes already, since this one is a lot of work. Who is bold, and daring!?!? It's ok to open a PR the next day that's incomplete.
• Change Ember Data examples to use Class Syntax - helpful to know Native Classes already, since this one is a lot of work. Who is bold, and daring!?!? It's ok to open a PR the next day that's incomplete.

High level tracking, in progress:

This section is purely for tracking how much work we still have left to do, in a very broad sense.

• Re-order TOC (as per RFC) [issue Re-order the table of contents #393]

Content Sections:

• What is Ember?
• Getting Started [issue Update Octane guides section - Getting Started: Quick Start #444]
• Tutorial
• Templates [issue Update Octane guides section: Templates #460]
• Working with JavaScript [issue Octane Guides: Working with JavaScript #429]
• Components [issue Octane guides: Component section (tracking issue) #395]
• Routing (includes Routes, Router, and Controllers) [issue Update Octane guides section - Routing #438]
• State management (aka computed properties)
• Services [issue Create new section: Services #461]
• Ember Data (renamed from "Models")
• Addons and dependencies (no change)
• Testing (no change)
• Configuration (no change)
• Application Concerns [issue Update guides section: Application Concerns #449]
• Developer Tools (renamed from "Ember Inspector")
• Upgrading (specifically Editions sub-section) [issue Create new section & sub-section: Upgrading/editions #463]
• References

[rtablada]

The content sections mentions Tutorials does this entail breaking the tutorials out to the separate repo, the Contact Book content, or both?

[jenweber]

@rtablada the plan is long term to break out the tutorials into a separate repo/app, but we need to focus on content first, and then infra after the first Octane release.

[ppcano]

It may be good to review what content needs to change regarding the MU layout and/or add a particular section?

[MelSumner]

Just to gently remind all of us, this is just supposed to be a minimum viable product.

[MonsieurDart]

Hello @MelSumner! Do we still have some parts of the guides to migrate to the new syntax? From my understanding, everything has been migrated. If not, I can tackle some of the remaining bits.

And, by the way, is there a way to see this new Guides MVP formatted somewhere? My question is a bit off-topic, but I have two newcomers arriving next week and I'd love them to start discovering Ember with the new syntax from day one! 😉

[NullVoxPopuli]

do some of these checkboxes need updating?

[jenweber]

I checked them all, mwahahaha.

Thanks everyone for your help! As of EmberConf 2019, we reached MVP for the Octane Guides 🎉

Anyone who wants to see the outcomes can visit https://emberjs.com/editions/octane for the preview guides. Octane isn't in a stable release of Ember - this is a preview - but we are in really good shape for when it's time to ship.