Component discovery docs

[pi0]

Currently we have sparse documentation about nuxt/components. Since this is an ad-hoc module (built-in feature with independent versioning) i think it would be the best to move and link docs from repo to official website so is easier for users to find all information in single place and avoid content to be stalled.

Goals:

• Adding "Features > Components Discovery" section
• Renaming "Features > Nuxt Components" to "Features > Components" (or built-in components?)
• Update "Directory Structure > Components" with components v2 docs (to be released)
• Update "Configuration Glossary > components" with detailed version of options (moving from repo)
• [q] Where to put advanced docs about extending components with hooks (module authors) and diagram? We may add it under features?
• Apply and mention conventions based on vue-style-guide (for base components, naming, etc)

Related PR: #1363 (not fully covering this issue atm)

[atinux]

Agree on it.

[q] Where to put advanced docs about extending components with hooks (module authors) and diagram? We may add it under features?

I think it could be directly into "Configuration Glossary > components".

Renaming "Features > Nuxt Components" to "Features > Components" (or built-in components?)

Features > Built-in Components

[pi0]

I think it could be directly into "Configuration Glossary > components

Hmm but i'm afraid other hooks aren't in configuration docs. This section would be also extended probably for including tips for unit test setup and internals

Features > Built-in Components

Seems good 👍

[atinux]

Hmm but i'm afraid other hooks aren't in configuration docs. This section would be also extended probably for including tips for unit test setup and internals

Indeed, listing hooks are tricky, see https://nuxtjs.org/docs/2.x/configuration-glossary/configuration-hooks#list-of-hooks

All the hooks lives in Internal Glossary, I don't know what would be the best place for Components hooks actually 😅

[pi0]

I would go with a try with internals then :)

[atinux]

It's now document here: https://preview.nuxtjs.org/docs/features/component-discovery

I am wondering that we should change the order for the Features group