Comments (3)
Proposed structure (currently implemented on Vuepress):
- Docs
- Guide
- Style Guide
- Tooling (core libraries + tooling, could be renamed to
Ecosystem
maybe?)
- API Reference
- Examples
- Examples (should find better name for current examples maybe)
- Cookbook
- Community - this should lead to a separate document where Help + News + Resource Lists are shown on the sidebar for easier navigation
from docs.
I think there are 2 types of links: internal links and external links.
For our main navigation, it's better to expand internal links more and fold up external links a little bit relatively, because we could assume users come here more like find out something inside I guess.
So my idea is:
- Docs (priority: 1)
- Guide
- Examples
- Style Guide
- Cookbook
- API Reference (priority: 2)
- Ecosystem (priority: 5)
- Official Projects
There could be a page to brief core libs/tools like: vuex, vue-router, vue-test-utils, vue-cli, vue-devtools, eslint-plugin-vue, etc. one-by-one. At the same time of course provide the link to each of the respective project. At very last, provide a link to our GitHub org to guide people explore more projects made by us. - Community
Another page maybe to brief how to get help, news, roadmap, events, social media accounts, jobs, partners, awesome projects and themes, by listing all useful links in categories.
- Official Projects
- Support Vue (priority: 3)
I think this should be here as the first level because we definitely need this IMO. - Translations (priority: 4)
- GitHub (priority: 100)
If the main navigation is too limited to contain all of these, then we could put the GitHub, Ecosystem, even Translations in some other ways or somewhere else.
Thanks.
from docs.
@Jinjiang I like this proposal!
We could put GitHub links to docs repo in the footer of every single page (via Edit this page on GitHub
link) and we have GH link to core repo on the homepage.
Rest are 5 links in navbar and I believe we can survive this amount 😅
from docs.
Related Issues (20)
- Which Chinese mainland person wrote "Vue" stupid translation HOT 1
- Missing search result for renderSlot HOT 1
- 中文文档部分按钮选项无法点击 HOT 3
- can't navigate to other url HOT 6
- How to use v-model-with-arguments in jsx HOT 1
- unpkg dont work HOT 4
- 官网部分*.js 文件出现404错误 HOT 2
- Two-way binding not working when using reactive, must use Ref HOT 7
- Super thin font on ios HOT 6
- Doc for `update:modelValue` or `update:*` event ? HOT 4
- setup 使用extends 生产环境报错,文档写的是不建议 HOT 5
- Change tag from div to li element
- Official website documentation-ecosystem-ui component BUG HOT 2
- Docs: Code blocks writing standards HOT 2
- the search function of the online page is not worked HOT 3
- 搜索功能点了没反应 HOT 2
- Add VNode type as the first argument of `h` HOT 1
- v-model parameters are different in Playground and web,makes it difficult to understand HOT 2
- Website home page nav bar looks weird on Firefox HOT 4
- Docs: unobvious warning in custom-directives HOT 4
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from docs.