ionic-team / ionic-docs

https://ionicframework.com/docs
Apache License 2.0
590 stars 3.03k forks source link

Docs structural changes #1203

Open tlancina opened 4 years ago

tlancina commented 4 years ago

With multiple frameworks and now Capacitor and Cordova both being first class solutions, there are some ways we can improve the current docs to be more user friendly.

Guide: The content in the Angular and React sections is similar, let's consolidate so they share the same URL and use something like the docs-tabs component.

perrygovier commented 4 years ago

Let's hold off on docs-tabs-like component with no visible tab for now. I'm not sure we're thinking the same thing when it comes to the implementation there.

I think first things first is to set up a better state management system to keep track of the currently active framework and platform.

Could we rename this to be that first step?

perrygovier commented 4 years ago

I shared this w/ @dwieeb in slack Screen Shot 2020-01-29 at 4 25 26 PM

perrygovier commented 4 years ago

Related

perrygovier commented 4 years ago

One of the things I think we're still unclear on.

If the page is entirely different and we're using the "framework redirect" approach, I think they should be different Markdown files entirely. So in in the docs there would be a navigation folder and then react.md, angular.md, and presumably others. If they're significantly different to begin with, I don't think finding some way to merge them in to one file is worth the added complexity.