tweaks to README, TODO and example

Author: baob

.env.example

@@ -1,5 +1,5 @@
 SLACK_SIGNING_SECRET=<secret from https://api.slack.com/apps/<your-slack-app>/general>
-PORT=<port you want your public facing bot to run on>
 SLACK_TOKEN=<token for slacks web api>
-SUBMIT_MESSAGE_TEMPLATE=Please follow <{{link}}|this link> to submit
-SUBMIT_LINK_TEMPLATE=<http://response.message/including?message={{message}}
+PORT=<port you want your public facing bot to run on>
+SUBMIT_LINK_TEMPLATE=https://airtable.com/path-to-the-form?prefill_Description={{ogDescription}}&prefill_Featured+Image={{ogImageUrl}}&prefill_Resources={{ogUrl}}&prefill_Project+Title={{ogTitle}}
+SUBMIT_MESSAGE_TEMPLATE=Please follow <{{submitLink}}|this link> to submit

README.md

@@ -1,6 +1,16 @@
 # README
 
-submit-this is a simple slack bot that can take a slack message, and construct a link (to a website of your choice) with the message included as a query parameter, and send you a slack message including the link. Designed to be useful for prefilling forms.
+submit-this is a simple slack bot that can take a slack message, and construct a link (to a website of your choice) with query parameters derived from your message, and send you a slack message including the link. Designed to be useful for prefilling forms.
+
+So, you could send the bot a message
+
+    @submitthis here is the data for submission
+
+and the text "here is the data for submission" would be sent to the form. Alternatively the message
+
+    @submitthis http://an.intersting.website.com
+
+would result in the opengraph data from the website (title, description, image) being sent to the form
 
 ## Setup
 
@@ -43,6 +53,8 @@ Configure more environment variables (differently in development and production
 - SUBMIT_MESSAGE_TEMPLATE - to customise the complete message created by the bot.  
 - SUBMIT_LINK_TEMPLATE - to customise the link created by the bot.  
 
+The message template in [.env.example](.env.example) is a full example of how this could be used with [airtable.com](https://airtable.com/), using opengraph data obtained from a link in the message you send to the bot.
+
 You may find [this formatting guide](https://api.slack.com/reference/surfaces/formatting#linking-urls) useful ... most importantly, it shows how to craft a message with a url linked from alternative text, since this bot will likely be creating long links.
 
 ### Start

TODO.md

@@ -12,14 +12,6 @@
 
 ## on a slack thread, takes the main message of the thread if no content
 
-## Exploit OpenGraph
-
-possibly using [openGraphScraper](https://github.com/jshemas/openGraphScraper) ( guide [here](https://davidwalsh.name/open-graph-data-nodejs) )
-
-## vscode
-
-test coverage and gutters
-
 ## flow
 
 can flow do anything useful (matching parameter lists ?) without needing babel.