README.md in openai-please-0.1.3 vs README.md in openai-please-0.2.0

@@ -8,30 +8,76 @@
 
 ## Installation
 
     $ gem install openai-please
 
-Ensure your [OpenAI API key](https://help.openai.com/en/articles/5480100-how-do-i-gain-access-to-openai-codex) is stored in an environment variable.
+Provide your [OpenAI API key](https://help.openai.com/en/articles/5480100-how-do-i-gain-access-to-openai-codex) in an environment variable, or using the [configuration file](#configuration).
 
 ```
 OPENAI_ACCESS_TOKEN=[YOUR ACCESS TOKEN HERE]
 ```
 
 ## Usage
 
+Type `please`, followed by an instruction written in natural language.
+
 ```shell
 user@host:~$ please find all files larger than 1 mb
 $ find . -type f -size +1M
 Run the command? (enter "h" for help) [y,n,e,h]
 ```
 
-You can [e]dit the command before running it by pressing the 'e' key. This uses the editor specified in the $EDITOR variable, defaulting to vi.
+You can [e]dit the command before running it by pressing the 'e' key. This uses the command specified in the `$EDITOR` variable, or `vi` if no editor is set.
 
+See `please --help` for more information.
+
+## Configuration
+
+You can modify the default configuration in `~/.config/please/config.yml`.
+
+```yaml
+send_pwd: false             # default: true
+send_ls: false              # default: true
+send_uname: true            # default: true
+
+access_token: ...           # default: $OPENAI_ACCESS_TOKEN
+
+examples:                   # default: []
+  - instruction: Run my super secret command
+    command: /super/secret/command
+    
+  - instruction: Show git status
+    command: git status
+    execute: true           # default: false
+    
+skip_default_examples: true # default: false
+```
+
+### `examples`
+
+Any examples listed here will be added to the prompt in the following form.
+
+```
+# INSTRUCTION
+$ COMMAND
+[RESULT, if execute is set to true]
+```
+
+If `execute` is set to true, the command will be executed prior to sending the request and the result will be included in the prompt. This is useful for providing dynamic context which the AI can use to inform completions.
+
+### `skip_default_examples`
+
+Do not include the default set of examples in the prompt. You can see the full prompt by running `please --show-prompt`. 
+
+*Note:* This option does not automatically imply `send_*: false`. To remove all examples from the prompt other than those explicitly specified, use this option in combination with the `send_*: false` options.
+
 ## Privacy
 
-In addition to the instruction text, the result of each of the following commands is sent to OpenAI Codex to improve the relevance of completions.
+By default, the result of each of the following commands is sent to OpenAI Codex to improve the relevance of completions.
 
 - `pwd`
 - `uname -a`
 - `ls -a`
+
+This behaviour can be disabled using the configuration options described above. You can review the prompt before sending it to OpenAI by running `please --show-prompt`. 
 
 See [OpenAI's privacy policy](https://beta.openai.com/policies/privacy-policy) for more information.