mobxjs / mobx-state-tree

Full-featured reactive state management without the boilerplate
https://mobx-state-tree.js.org/
MIT License
6.9k stars 640 forks source link

Docs: add comparison between React Context/Reducer #2158

Closed coolsoftwaretyler closed 3 months ago

coolsoftwaretyler commented 4 months ago

What does this PR do and why?

Draft while I work on this, happy to take feedback and edits.

I want to add a section to the docs site that compares MST against alternatives. I'm starting with React Context/Reducer since it's one of the "basics" in many ways.

Posting this PR early for as much feedback as possible.

If you want an easier format to read it in:

  1. Pull down this branch
  2. cd website && bun run start or cd website && yarn run start
  3. Docusaurus should open a browser tab automatically. Visit http://localhost:3001/compare/context-reducer-vs-mobx-state-tree to read in style.
coolsoftwaretyler commented 3 months ago

I'm gonna plan to merge this over the weekend. I'll do another read-through before I do that, and I'll publish the docs off the 5.4.1 version so they don't confuse folks with some of the code changes we've made since building the site is coupled to automatically generating the API docs.