search

redfin / react-server

:rocket: Blazing fast page load and seamless navigation.
https://react-server.io/
Apache License 2.0
3.89k stars 184 forks source link

Document Architecture Decisions #813

Open drewpc opened 7 years ago

drewpc commented 7 years ago

This is also probably a good time to recommend documenting architecture decisions in the project. The project itself is very opinionated (which is great!), so all of that should be documented to help explain the reasons behind the decisions. I'd recommend reading these:

There's a lot of churn in the open issues and PRs about HTTP/HTTPS servers, applications like Express, Koa, Hapi.js, etc, CORS, ReactServerAgent using SuperAgent or fetch, Webpack 1 vs Webpack 2, isomorphic Webpack, embedding Webpack Dev Server, multiple processes....and that's just stuff I've been involved in!

Now that more and more people are using this, decisions to "should we include Webpack Dev Server for client side HMR?" greatly impacts decisions to "can we support Koa instead of Express?"

I'm happy to submit an initial PR if anyone's interested.

gigabo commented 7 years ago

Yeah, it would be nice to have a document to point to instead of continually re-hashing things.

Good idea @drewpc.