Core-packages pages

[xtuc]

Refers to #1021.

Index page:

@hzoo The index page could replace usage > API (https://babeljs.io/docs/usage/api/). We can then move the doc in babel-core (https://github.com/babel/babel/blob/master/packages/babel-core/README.md).

usage > babel-register (https://babeljs.io/docs/usage/babel-register/) same problem.

[xtuc]

@hzoo @existentialism What are your thought about this ? I will then move/link some pages from babel/babel.github.io to babel/babel.

[hzoo]

we can call it the package name if it's better - and does that link work?

[xtuc]

This is a relative link (points to docs/core-packages/types).

[hzoo]

Do you think it should be babel-types or types

[xtuc]

I did prefix all package in c9a8804

[existentialism]

Might not need to solve this now, but some things to think about as we establish more consistency across docs:

• Title case for titles?
• Perhaps super nitpicky, but it's semi strange to have an h2 (Core) followed by another h2 (Install)

Otherwise LGTM, nice work!

[hzoo]

Docs have a lot of inconsistency yeah - kinda wish we could lint (I know there's a few markdown linters)

[xtuc]

It would be great to lint babel/babel/packages/*/README.md.

[hzoo]

yeah with a markdown AST plus custom rules 😛

I know there's https://github.com/textlint/textlint by @azu but I haven't checked it out that much

[xtuc]

• /docs/usage/api is now babel-coreREADME (ef667bb)
• /docs/usage/babel-register is now babel-register README (9fbb62b)

@existentialism @hzoo @mareksuscak

[hzoo]

Merging in #1044