Fix: at now curried + some addition to documentation (#677)

* link to PACKAGES.md in Readme, add @most/adapter to PACKAGES.md

* curry2 at

* doc: newStream

* Revert "curry2 at"

This reverts commit e7072a2.

* docs: newStream() example now uses a dispose function

* update signature in doc that at is not curried

PACKAGES.md

@@ -6,6 +6,7 @@
 | [hold](https://github.com/mostjs/hold) | Deliver the most recently seen event to new observers
 | [create](https://github.com/mostjs/create) | Imperatively push events into a Stream
 | [dom-event](https://github.com/mostjs/dom-event) | Streamlined DOM Events
+| [adapter](https://github.com/mostjs/adapter) | Imperatively put events into mostjs streams
 | [examples](https://github.com/mostjs/examples) | Most.js examples
 
 ### Most Tools for  Contributors

README.md

@@ -18,6 +18,7 @@ Specifically, `@most/core` features Most's battle-tested, high-performance archi
 * [API docs](https://mostcore.readthedocs.io)
 * [Get it](#get-it)
 * [Examples](examples)
+* [Packages](PACKAGES.md)
 * [Contribute](#contribute)
 
 ## Get it

docs/api.rst

@@ -286,7 +286,8 @@ at
 
 .. code-block:: haskell
 
-  at :: Time -> a -> Stream a
+  at :: (Time, a) -> Stream a
+  at :: Time -> Stream void
 
 Create a :ref:`Stream` containing a single event at a specific time. ::
 
@@ -318,6 +319,35 @@ Create a :ref:`Stream` that fails with the provided ``Error`` at time 0.  This c
 
   throwError(X): X
 
+.. _newStream:
+
+newStream
+`````````
+
+.. code-block:: haskell
+
+  newStream :: ((Sink a, Scheduler) -> Disposable) -> Stream a
+
+Create a :ref:`Stream` from a custom event producer (i.e. :ref:`run` method).
+
+.. code-block:: javascript
+
+  import { currentTime as ct } from '@most/scheduler'
+
+  // Number -> a -> Stream a
+  const valueAt = delay => value => newStream(
+    (sink, scheduler) => {
+      const publishVal = val => {
+        sink.event(ct(scheduler), val);
+        sink.end(ct(scheduler));
+      };
+      const timer = setTimeout(publishVal, delay, value);
+      return { dispose: () => { clearTimeout(timer); } };
+    }
+  );
+
+  valueAt(1000)(7): ---7|
+
 Extending
 ^^^^^^^^^