better docs

Author: jdegoes

MODULES.md

@@ -46,8 +46,9 @@ Unwraps the canceler function from the newtype that wraps it.
 cancelWith :: forall e a. Aff e a -> Canceler e -> Aff e a
 ```
 
-If the first asynchronous computation is canceled, then the specified 
-canceler will also be called.
+This function allows you to attach a custom canceler to an asynchronous
+computation. If the computation is canceled, then the custom canceler 
+will be run along side the computation's own canceler.
 
 #### `launchAff`
 

output/examples.js

@@ -50,8 +50,9 @@ module Control.Monad.Aff
   cancel :: forall e. Canceler e -> Error ->  Aff e Boolean
   cancel (Canceler f) = f
 
-  -- | If the first asynchronous computation is canceled, then the specified 
-  -- | canceler will also be called.
+  -- | This function allows you to attach a custom canceler to an asynchronous
+  -- | computation. If the computation is canceled, then the custom canceler 
+  -- | will be run along side the computation's own canceler.
   cancelWith :: forall e a. Aff e a -> Canceler e -> Aff e a
   cancelWith aff c = runFn3 _cancelWith nonCanceler aff c