diff --git a/docs/FAQ.md b/docs/FAQ.md new file mode 100644 index 0000000..07163a5 --- /dev/null +++ b/docs/FAQ.md @@ -0,0 +1,11 @@ +# FAQ + +### What is the added value versus all the boilerplate projects out there like [create-react-app](https://github.com/facebookincubator/create-react-app)? + +The proliferation of boilerplate and metapackages is one thing we are trying to reduce. These types of projects +are great, and do serve a purpose. But what if you wanted to make a configuration change across all your +projects? You must make config changes in many places, including the original boilerplate, whereas presets +give you the power to confine these changes to a single package. Some of these projects also make a tradeoff +between ease of set up and black-boxing the configuration. Once you decide to make a configuration change, +you are forced to maintain the entire configuration and its dependencies in perpetuity. We believe Neutrino +represents a good balance between ease of set up and future extensibility. diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md index ebd77ba..15bc73a 100644 --- a/docs/SUMMARY.md +++ b/docs/SUMMARY.md @@ -4,6 +4,7 @@ * [Installation](/installation.md) * [Usage](/usage.md) * [Project Layout](/project-layout.md) +* [FAQ](/FAQ.md) * [Presets](/presets/README.md) * [Web](/presets/neutrino-preset-web/README.md) * [React](/presets/neutrino-preset-react/README.md)