nuxt / nuxt

The Intuitive Vue Framework.

Home Page:https://nuxt.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

nuxt provides a simplified version of the documentation

1057105012 opened this issue · comments

Describe the feature

I think nuxt's documentation is too complicated, I think there are a lot of experimental, various ingenious ideas in it, but this also brings a problem, which is the increase in cognitive cost. I hope nuxt will propose a basic template of best practices as a common development scaffold, and split the documentation into advanced and basic versions. For example, what are the core components of nuxt, routing, server-side rendering, API writing methods, these are actually all beginners care about, as for how to make images faster, fonts more elegant, these are rarely relevant in the initial stage, what beginners do not care about, I think the nuxt official can provide their own best-looking and optimal settings, not exposed to developers, just as the default values of the basic template. If the documentation is simplified, the cognitive cost is reduced, for beginners, nuxt is also easier to accept, this is a good thing. Because many times, we do not prioritize "performance" and "clever design."

Additional information

  • Would you be willing to help implement this feature?
  • Could this feature be implemented as a module?

Final checks

IMO that's more or less the sidebar when using "Get started"

image

What do you think would be too complicated in these sections?