Skip to content

Commit

Permalink
FAQ (#3138)
Browse files Browse the repository at this point in the history
* Misconceptions

* wip

* wip

* wip

* Update FAQ.md

* Update FAQ.md

* wip

* Update FAQ.md

* wip

---------

Co-authored-by: Stephen Celis <stephen@stephencelis.com>
  • Loading branch information
mbrandonw and stephencelis authored Jun 4, 2024
1 parent 64f7180 commit d2d79f3
Show file tree
Hide file tree
Showing 4 changed files with 238 additions and 24 deletions.
25 changes: 3 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -634,28 +634,8 @@ to a [Gist](https://gist.github.com)!

## FAQ

* How does the Composable Architecture compare to Elm, Redux, and others?
<details>
<summary>Expand to see answer</summary>
The Composable Architecture (TCA) is built on a foundation of ideas popularized by the Elm
Architecture (TEA) and Redux, but made to feel at home in the Swift language and on Apple's
platforms.

In some ways TCA is a little more opinionated than the other libraries. For example, Redux is
not prescriptive with how one executes side effects, but TCA requires all side effects to be
modeled in the `Effect` type and returned from the reducer.

In other ways TCA is a little more lax than the other libraries. For example, Elm controls what
kinds of effects can be created via the `Cmd` type, but TCA allows an escape hatch to any kind
of effect since `Effect` wraps around an async operation.

And then there are certain things that TCA prioritizes highly that are not points of focus for
Redux, Elm, or most other libraries. For example, composition is very important aspect of TCA,
which is the process of breaking down large features into smaller units that can be glued
together. This is accomplished with reducer builders and operators like `Scope`, and it aids in
handling complex features as well as modularization for a better-isolated code base and improved
compile times.
</details>
We have a [dedicated article][faq-article] for all of the most frequently asked questions and
comments people have concerning the library.

## Credits and thanks

Expand Down Expand Up @@ -711,6 +691,7 @@ This library is released under the MIT license. See [LICENSE](LICENSE) for detai
[gh-discussions]: https://github.com/pointfreeco/swift-composable-architecture/discussions
[swift-forum]: https://forums.swift.org/c/related-projects/swift-composable-architecture
[testing-article]: https://pointfreeco.github.io/swift-composable-architecture/main/documentation/composablearchitecture/testing
[faq-article]: https://pointfreeco.github.io/swift-composable-architecture/main/documentation/composablearchitecture/frequentlyaskedquestions
[dependencies-article]: https://pointfreeco.github.io/swift-composable-architecture/main/documentation/composablearchitecture/dependencymanagement
[getting-started-article]: https://pointfreeco.github.io/swift-composable-architecture/main/documentation/composablearchitecture/gettingstarted
[navigation-article]: https://pointfreeco.github.io/swift-composable-architecture/main/documentation/composablearchitecture/navigation
Expand Down
Loading

0 comments on commit d2d79f3

Please sign in to comment.