Update readme.md

Author: RickCarlino

readme.md

@@ -1,6 +1,6 @@
 # PLEASE READ
 
-You might not need to install this software. This software is used by the FarmBot team and advanced users who run their own FarmBot servers. We highly recommend that you use our publicly hosted server at [my.farmbot.io](http://my.farmbot.io), which elimintes the need for server setup.
+You might not need to install this software. This software is used by the FarmBot team and advanced users who run their own FarmBot servers. We highly recommend that you use our publicly hosted server at [my.farmbot.io](http://my.farmbot.io), which eliminates the need for server setup.
 
 # How It Works
 
@@ -9,23 +9,24 @@ Farmbot uses [MQTT](https://en.wikipedia.org/wiki/MQTT) for realtime events. On
 ## Our MQTT Implementation
 
  * Log in to the broker using the same email as on the web app. A JSON Web Token from the API can be used as a password.
- * Messages are sent using [JSON RPC](https://en.wikipedia.org/wiki/JSON-RPC).
+ * Messages are sent using [Celery Script](https://github.com/RickCarlino/farmbot-js/blob/master/src/corpus.ts), which is a domain-specific JSON format used to send messages (and sequences) to FarmBot. If you would like documentation or specifics, please let me know via an issue. CeleryScript transmission is usually handled by [FarmBotJS](https://github.com/FarmBot/farmbot-js), a wrapper library that eliminates the need to write Celery Script directly.
 
 ## Available MQTT Topics
-
  * `bot/device_{ BOT_ID }/from_clients`: Commands originated from browsers and clients.
  * `bot/device_{ BOT_ID }/from_device`: This is where the bot publishes messages.
+ * `bot/${uuid}/status`: Everytime bot state changes (Eg: a pin is flipped, movement, etc.) a JSON representation of the bot status is sent.
+ * `bot/${uuid}/logs`: General log messages. The same ones seen on the nav bar of the FarmBot Web App.
 
-Subscribing to `bot/{ BOT_UUID }/*` via 3rd party MQTT client (Such as [MQTT FX](http://mqttfx.jfx4ee.org/index.php/download)) is useful for debugging and monitoring.
+Subscribing to `bot/{ BOT_UUID }/*` via 3rd party MQTT client (Such as [MQTT FX](http://www.mqttfx.org/)) is useful for debugging and monitoring.
 
 # Installation
 
 1. git clone THIS_REPO
 2. cd THIS_REPO
 3. npm install
 4. Setup and run the [Web API](https://github.com/FarmBot/Farmbot-Web-API) locally. We recommend running it on `http://localhost:3000`
-5. `WEB_API_URL=http://localhost:3000 node app/index.js`. See note below*.
-6. Websocket MQTT is now available via `ws://localhost:3002` and `wss://localhost:443`.  Raw MQTT (TCP connections) are available via `mqtt://localhost:1883`. 
+5. `WEB_API_URL=http://localhost:3000 npm start`. See note below*.
+6. Websocket MQTT is now available via `ws://localhost:3002` and `wss://localhost:443`.  Raw MQTT (TCP connections) are available via `mqtt://localhost:1883`.
 
 \* The assumption is that you are running a [Web API](https://github.com/FarmBot/Farmbot-Web-API) instance on `localhost:3000`. If you are using a different API server, please change `WEB_API_URL` accordingly.
 
@@ -52,4 +53,4 @@ See `DEPLOYMENT.md`.
 
 # Want to Help?
 
-[Low Hanging Fruit](https://github.com/FarmBot/mqtt-gateway/search?q=TODO&utf8=%E2%9C%93)
+See [TODO items in the codebase](https://github.com/FarmBot/mqtt-gateway/search?q=TODO&utf8=%E2%9C%93) or ask how you can help via an issue.