reduxjs / redux

A JS library for predictable global state management
https://redux.js.org
MIT License
60.91k stars 15.27k forks source link

Restructure "Ecosystem" docs page #2588

Closed markerikson closed 6 years ago

markerikson commented 7 years ago

The "Ecosystem" page is currently a bit of a scattershot list (current version for reference). There's a mixture of random tutorial links, translations, bindings, middleware, and other addons.

The page describes itself as "staff picks", and also that "the Redux staff has vetted them personally". Really, at this point that's not exactly true. We've had lots of people submit their own libs over time, and while someone did presumably approve each merged PR, I'm not sure we really "vetted" things per se.

On a similar note, there's a great quote from Andrew and Dan at https://github.com/reactjs/redux/issues/215#issuecomment-118639342:

As @gaearon said once, (I can't remember where... probably Slack) we're aiming to be like the Koa of Flux libraries. Eventually, once the community is more mature, the plan is to maintain a collection of "blessed" plugins and extensions, possibly under a reduxjs GitHub organization.

I don't think we're going to actually maintain any additional libs at this point, but we can certainly highlight ones that are widely used or specifically interesting in some better ways.

I talked with Dan at ReactRally about revamping this page. I don't have an absolutely specific plan in mind yet, but some rough thoughts:

SadPandaBear commented 7 years ago

Another rough thoughts and reviews:

I'd suggest changing "Using Redux" to "Tools & Resources" or something like that.

Review all existing links for relevance

No broken links, but I will check it out later if any Github repositories' links can be a link to a website that was created after the Ecosystem file was written.

Stop advertising "Awesome-Redux" at the top of the page. It's okay to leave it in a list of "Useful Resources", but in my (very biased) opinion, it's a link dump that's insufficiently organized. (FWIW, I think Dan actually suggested that change first, and Sindre Sorhus felt it was poor enough that he didn't accept it into his "awesome-awesome" list.)

We actually have this "More" session in the end of the file... I think that by just removing it from the top should do.

ishankbahl commented 7 years ago

Suggestion: The talks can be put in iframes using any plugin for gitbook (Not sure if it is possible).

This issue seems interesting, can I work on this?

markerikson commented 6 years ago

Got started on this task tonight. My first step is to remove all the "learning"-type links from the Ecosystem page, and create a new "Learning Resources" page. At the moment, I'm mostly dropping the existing links entirely, and creating a new set of links that's based off the categories and entries in my React/Redux links list.

From there, I plan to fill out the new Ecosystem page in a style that's similar to my ReactBoston slides on the Redux ecosystem. The goal is to show some of the categories of libraries that are out there, highlight some of the "best" or most widely-used addons in each category, and give information on when and why you might want to use them.