-
Notifications
You must be signed in to change notification settings - Fork 53
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Document the effects and their carriers. #251
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is looking good! A bunch more notes but it’s shaping up really nicely.
Co-Authored-By: Rob Rix <robrix@github.com>
Co-Authored-By: Rob Rix <robrix@github.com>
Co-Authored-By: Rob Rix <robrix@github.com>
Co-Authored-By: Rob Rix <robrix@github.com>
Co-Authored-By: Rob Rix <robrix@github.com>
Co-Authored-By: Rob Rix <robrix@github.com>
Co-Authored-By: Rob Rix <robrix@github.com>
Co-Authored-By: Rob Rix <robrix@github.com>
Co-Authored-By: Rob Rix <robrix@github.com>
Co-Authored-By: Rob Rix <robrix@github.com>
Co-Authored-By: Rob Rix <robrix@github.com>
Co-Authored-By: Rob Rix <robrix@github.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Good stuff 👍 just a couple more notes, then let’s merge 🎉
src/Control/Effect/Class.hs
Outdated
@@ -1,4 +1,6 @@ | |||
{-# LANGUAGE DefaultSignatures, EmptyCase, FlexibleContexts, FlexibleInstances, MultiParamTypeClasses, RankNTypes, TypeOperators #-} | |||
|
|||
-- | Provides the 'HFunctor' and 'Effect' classes that an effect type implements so that a carrier monad can provide an instance of 'Carrier' for that type. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Carrier
isn’t in scope here, and IMO we don’t need to mention it.
src/Control/Effect/Resumable.hs
Outdated
-- Note that the type parameters in the @err a@ paramater and @m a@ parameter must match | ||
-- up; this is so that the calling context knows what type of value this computation | ||
-- expected in the success case. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
-
Suggest: “…; this indicates the type that the error must be resumed with.”
-
Soft wrap, please 🙏
Co-Authored-By: Rob Rix <robrix@github.com>
#240 mentioned, very correctly, that our documentation was a little sparse, and that’s a problem that only grew worse with the various reorganizations on the road to 1.0. This patch remedies that.
Fixes #244.