Reorganize headings

[hzoo]

• If we want to add a "syntax highlighting" guide/section where can it go?

Maybe we can move Learn ES2015 since it's on the page in a few other places

[mareksuscak]

IMO we could replace "Learn ES2015" with "Docs", "Guides" or "Recipes" or something similar. Possibly also moving some of the top level sections under that new entry.

[hzoo]

Ok maybe make it Docs | Setup | Try it Out | FAQ?

[mareksuscak]

@hzoo Yeah that would make a lot of sense. Where to put Learn ES2015, Plugins and Usage tho? The first two could become subsections of the Docs but Usage contains its own subsections. How to deal with that? 2nd level subsections?

[hzoo]

We could just move everything in Usage under Docs and only have 1 subsection

[hzoo]

It hasn't been updated in a while so definetely can try some different stuff out

[danharper]

I think the docs need a sidebar, like the React docs.

How about this for a re-structured top nav:

Primary Nav (left):

* Docs
* Try it out
* Community
* Blog

Secondary Nav (right):

* Twitter
* GitHub

Then on the Docs page, the following sidebar:

# Quick Start

* Browser
* Node
* Plugins
* Polyfills
* Caveats (or.. Browser Support)
* Editors
* Linting
* Babili (Minification)

# Advanced Usage

* Options
* CLI
* babel-node
* In-Browser Compilation
* Babel API

I'm unsure where a "Learn ESXXX" would go, but wherever it goes perhaps just give "highlights" and link off-site for the details. Plenty of community resources for that.

[hzoo]

So the docs used to have a sidebar for headings (per page) but there was some bug when moving from redcarpet to kramdown that i didn't figure out

Yeah having more pages and more split apart rather than all in plugins would be great

[mareksuscak]

You mean this sidebar?

Has it been fixed recently or you meant another one? I'd love to help move this guy forward so what's the final decision? Do we want to add yet another sidebar on the left or just keep it as simple as it is now and have one huge page containing all the sections?

[hzoo]

Yeah the sidebar you have there is the one that got fixed (the script was loading).

I was meaning the header at the top - we should simplify that somehow

Maybe just Docs | Setup | Try it Out on the left, or even just Docs | Try It Out and then create a docs page that links to everything else.

And yes we should split up the plugins page since that is huge (one easy change is a page that explains what plugins are (the info) vs the list of actual plugins)