better doc comments

README.md

@@ -2,6 +2,8 @@
 
 Start Elm apps without views
 
+### Example
+
 ```elm
 port module Main exposing (..)
 
@@ -44,7 +46,8 @@ main =
         }
 ```
 
-```js
+
+```javascript
 var app = Elm.Main.worker()
 app.ports.modelOut.subscribe(function (model) {
   document.getElementById('seconds').innerHTML = model.toString()

elm-package.json

@@ -1,5 +1,5 @@
 {
-    "version": "1.0.0",
+    "version": "1.0.1",
     "summary": "Start Elm applications without a view",
     "repository": "https://github.com/lukewestby/worker.git",
     "license": "MIT",

src/Worker.elm

@@ -38,16 +38,28 @@ wrapInit extraCmds innerInit =
             )
 
 
-{-| Start a worker program with flags from the outside world
+{-| Start a worker program with flags from the outside world, including extra
+Cmds to wrap init and update in case you want to include port calls on every
+Msg.
 
-    ```javascript
-    // Program { userId : String, token : String }
+In your Elm program
+
+    port modelOut : Model -> Cmd msg
+
+    main : Program { userId: String, token : String }
+    main =
+        Worker.workerWithFlags modelOut
+            { init = \{ userId, token } -> init userId token
+            , update = update
+            , subscriptions = subscriptions
+            }
+
+In JavaScript
 
     var app = Elm.MyApp.worker({
         userId: 'Tom',
         token: '12345'
     });
-    ```
 -}
 workerWithFlags :
     (model -> Cmd msg)
@@ -65,7 +77,18 @@ workerWithFlags extraCmds { init, update, subscriptions } =
         }
 
 
-{-| Start a worker program
+{-| Start a worker program, including extra Cmds to wrap init and update in case
+you want to include port calls on every Msg.
+
+    port modelOut : Model -> Cmd msg
+
+    main : Program Never
+    main =
+        Worker.worker modelOut
+            { init = init
+            , update = update
+            , subscriptions = subscriptions
+            }
 -}
 worker :
     (model -> Cmd msg)
@@ -82,7 +105,17 @@ worker extraCmds { init, update, subscriptions } =
         }
 
 
-{-| Start a worker program with just a model a simpler update function
+{-| Start a worker program with just a model and a simpler update function
+
+    port modelOut : Model -> Cmd msg
+
+    main : Program Never
+    main =
+        Worker.beginnerWorker modelOut
+            { model = model
+            , update = update
+            }
+
 -}
 beginnerWorker :
     (model -> Cmd msg)