README.md in markdown_exec-1.0.0 vs README.md in markdown_exec-1.1.0

@@ -148,11 +148,11 @@
 
 ## Tab Completion
 
 ### Install tab completion
 
-Append a command to load the completion script to your shell configuration file:
+Append a command to load the completion script to your shell configuration file. `mde` must be executable for the command to be composed correctly.
 
 ```bash :()
 echo "source $(mde --pwd)/bin/tab_completion.sh" >> ~/.bash_profile
 ```
 
@@ -195,5 +195,36 @@
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
 # Code of Conduct
 
 Everyone interacting in the MarkdownExec project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/markdown_exec/blob/master/CODE_OF_CONDUCT.md).
+
+###
+i made a tool to help me execute shell commands for ansible, aws, etc.
+
+normally the scripts have a base configuration followed by one or more blocks of commands that must be executed with the base configuration.
+
+by storing the shell scripts in a markdown file, there is room for both code and explanatory text. the tool provides the interface that names all the code blocks in the file and allows the the user to select and preview the code to execute.
+
+i use it regularly to manage deployment processes that require dozens of steps with ease and re-playablity.
+
+the gem is hosted at `https://github.com/fareedst/markdown_exec`.
+
+please install the Ruby gem with `gem install markdown_exec` and let me know how the installation goes for you. i would like to see if your current deployment scripts can fit into this model.
+
+```bash :test1
+files="$(ls -A .)"
+PS3='?'
+select filename in ${files}; do echo "You selected ${filename}"; break; done
+
+echo "-1"
+echo $0
+echo 'AA'
+echo 'name? '
+read name
+echo 'type? '
+read type
+echo 'BB'
+echo "name: $name"
+echo "type: $type"
+echo 'CC'
+```