polish up readme

README.md

@@ -1,4 +1,6 @@
-Autolab from the CLI. Decan't you see why that's awesome?
+# Decanter
+Decanter is a CLI app for interacting with Autolab at UB (University at Buffalo ...).
+_Pour_ data from your computer to Autolab, a little more seamlessly.
 
 ## Installation
 `brew install p5quared/decanter/decanter`
@@ -7,13 +9,16 @@ or build from source via `go install`.
 
 ## Usage
 
+Before you can do much of anything, you need to setup Decanter via `decanter setup`.
+You will be prompted to 
+
 To view an overview, use `decanter -h`.
 
 Some examples are:
 
 * `decanter list me`
 * `decanter list assessments`
-* `decanter submit -c cse486-s24 -a PA2 -f submission.tar`
+* `decanter submit -c cse305-s24 -a pangram -f main.ml`
 
 ## Notes
 
@@ -22,10 +27,26 @@ might refer to as a ravenous madman. If you find issues
 or have suggestions, I'd love to hear about them in the
 Github issues section.
 
-I'd also appreciate contributions. If you'd like to contribute,
+Contributions would be appreciated. If you'd like to contribute,
 please email me or write an issue first. There's also a long
 list of TODO's that I have written down and scattered throughout
 the code.
 
 At some point I'll be cleaning up the Autolab API and publishing
 it as a standalone library.
+
+
+## FAQ
+
+* _When I view my submission scores, I can't see the total (score / x)!_
+    * The Autolab API only returns problem scores, and requires instructor scopes to access maximum scores. *shrug*
+* _Why can't I do XYZ with Decanter?_
+    * Hey come on, I'm only one person here.
+* _Why is it red and not blue?_
+    * Red is the color of passion, here are some great red things:
+        * The Northern Cardinal
+        * The <3 in I <3 NY
+        * The leaves of a Japanese maple tree.
+        * My copy of _Crime and Punishment_
+        * _etc..._
+    * If that doesn't satisfy you, I also want make sure nobody is confused about the fact that this app is not directly affiliated with UB in any way.