-
Notifications
You must be signed in to change notification settings - Fork 74
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Port Aff explanation to file that explains it somewhat; update ReadMe
- Loading branch information
1 parent
84a7ca2
commit c4dac60
Showing
3 changed files
with
15 additions
and
16 deletions.
There are no files selected for viewing
13 changes: 13 additions & 0 deletions
13
21-Hello-World/03-Hello-World-and-Effects/src/11-Effect-Eff-and-Aff.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,13 @@ | ||
# Effect, Eff, and Aff | ||
|
||
## Some History | ||
|
||
Before the `0.12.0` release, the `Effect` monad used to be called `Eff`. | ||
|
||
In short, the decision was made to drop `Eff`'s "extensible effects". Presumably, to prevent code breakage, `Eff` and package location in imports was unchanged. Rather, it can now be found in the [purescript-eff](https://pursuit.purescript.org/packages/purescript-eff/3.2.1) package. Its replacement was called `Effect`. | ||
|
||
(You can read more about the decision making process [here](https://purescript-resources.readthedocs.io/en/latest/eff-to-effect.html). If one is curious about `Eff`, read through [the related section](https://leanpub.com/purescript/read#leanpub-auto-the-eff-monad-1) in the "Purescript by Example" book as it won't be covered here.) | ||
|
||
The `Aff` monad was introduced and in use before this decision was made. Thus, history explains the naming behind `Aff`: if `Eff` was for synchronous **eff**ects, then `Aff` is for **a**sychronous e**ff**ects. | ||
|
||
`Aff` is more powerful than `Effect`, but why that is won't be explained now. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,19 +1,5 @@ | ||
# Effect, Eff, and Aff | ||
|
||
## Some History | ||
|
||
Before the `0.12.0` release, the `Effect` monad used to be called `Eff`. | ||
|
||
In short, the decision was made to drop `Eff`'s "extensible effects". Presumably, to prevent code breakage, `Eff` and package location in imports was unchanged. Rather, it can now be found in the [purescript-eff](https://pursuit.purescript.org/packages/purescript-eff/3.2.1) package. Its replacement was called `Effect`. | ||
|
||
(You can read more about the decision making process [here](https://purescript-resources.readthedocs.io/en/latest/eff-to-effect.html).) | ||
|
||
The `Aff` monad was introduced and in use before this decision was made. Thus, history explains the naming behind `Aff`: if `Eff` was for synchronous **eff**ects, then `Aff` is for **a**sychronous e**ff**ects. | ||
|
||
## Scope of This Folder | ||
|
||
If one is curious about `Eff`, read through [the related section](https://leanpub.com/purescript/read#leanpub-auto-the-eff-monad-1) in the "Purescript by Example" book as it won't be covered here. | ||
|
||
Since `Effect` has already been explained, our focus will be on `Aff` and its relation and usage with `Effect`. In this folder, we'll peel back the covers of `Node.ReadLine.CleanerInterface` and cover more of `Aff`. | ||
|
||
However, `Aff` will not be covered in its full complexity. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters