Reducers are really interesting, but I've had some trouble figuring out how all the pieces fit together. I think this is why:
Functional libraries are composed of granular functions. This means everything is re-usable. It also means there is not a clear distinction between API and internal functions, as you get with OOP. This makes it harder to understand how to fit the pieces together for your app.
Single-verb functions are expressive when writing code but not descriptive when reading the library. Without comments, in order to understand a function you must understand the internals of all the functions from which it is composed.
All this to say, I want to help out by adding docstrings and literate-style comments. comments branch is based on browser branch, which seems to be the most up-to-date.
travisbot
commented
12 years ago
Reducers are really interesting, but I've had some trouble figuring out how all the pieces fit together. I think this is why:
All this to say, I want to help out by adding docstrings and literate-style comments.
commentsbranch is based on browser branch, which seems to be the most up-to-date.