Improve readme, add Acknowledgements

Author: jerrymarino

README.md

@@ -1,23 +1,28 @@
 # Swifty Swift Vim
 
-Swifty Swift Vim is a semantic editor backend for Vim and YouCompleteMe.
+Swifty Swift Vim is a semantic editor backend swift tailored to the needs of
+text editors.
 
-## Usage
+It was originally designed to integrate Swift into [YouCompleteMe](https://github.com/Valloric/YouCompleteMe/).
 
-Install the pull request branch of YCMD into YouCompleteMe.
+## YouCompleteMe Usage
+
+Install the [RFC branch of YCMD with Swift Supprt](https://github.com/Valloric/ycmd/pull/487)
+into your YouCompleteMe installation.
 
 Typically, this means going into wherever you cloned YouCompleteMe and then:
 
 ```
   mv third_party/ycmd third_party/ycmd-master
   git clone  https://github.com/jerrymarino/ycmd.git
 
-  # Checout the RFC branch
+  # Checkout the RFC branch 
   git checkout remotes/origin/jmarino_swift_prototype_squashed
   git submodule update --init --recursive
 
   # Build with swift support
-  ./build.py
+  # ( Also, keep clang and potentially debug symbols --debug-symbols )
+  ./build.py  --completers --swift-completer --clang-completer
 ```
 
 By default VIM does not support the `swift` filetype.
@@ -28,16 +33,16 @@ Cat this into your `.vimrc`
     autocmd BufNewFile,BufRead *.swift set filetype=swift
 ```
 
-Then, assert it's set to the correct value when a swift file is open.
+Then, assert it's set to the correct value when a `swift` file is open.
 
 ```
     :set ft?
 ```
 
-## Supported Features:
-
-- Semantic Completion
+## Supported Features
 
+- Code Completion
+- Semantic Diagnostics
 
 ## Design
 
@@ -69,7 +74,7 @@ distribution.
 ### Features
 
 It eventually supports: semantic completion, GoTo definition, diagnostics,
-symbol useage, and documentation displaying. It should support compile command
+symbol usage, and documentation displaying. It should support compile command
 configuration via flags and a JSON compilation database to support complex
 projects, similar to clang's JSON compilation database.
 
@@ -80,7 +85,7 @@ designed to work with YouCompleteMe YCMD. It uses HTTP as a protocol to
 integrate with YouCompleteMe:
 [https://val.markovic.io/articles/youcompleteme-as-a-server](YouCompleteMe)
 
-The frontend is build on Beast HTTP and Boost ASIO
+The frontend is build on [Beast](https://github.com/vinniefalco/Beast) HTTP and Boost ASIO
 
 
 ## Development
@@ -91,6 +96,33 @@ In the root directory, you can setup the repository with 1 line
   ./bootstrap
 ```
 
-I log random musings about the trials and tribulations of developing and using
-this in `notes.txt`. 
+I log random musings about developing and using this in `notes.txt`. 
+
+This project is still in early phases, and development happens sporadically.
+
+**Contributions welcome**
+
+### Ideas for starter projects
+- Write documentation that explains how to use this
+- Improve build system and dependency integration
+- Design an end to end integration testing system
+- Integrate GoogleTest for CPP units
+- Get `GoToDefinition` working end to end
+- Implement a semantic search engine
+- Add the ability to bootstrap a project from an Xcode project
+
+### Ideas for YCM starter projects
+- Integrate Diagnostic support with YouCompleteMe
+- Add support for swift `.ycm_extra_conf`s in YCMD.
+
+## Acknowledgements 
+
+The HTTP server stands on the shoulders of [Beast](https://github.com/vinniefalco/Beast)(s).
+Many thanks to @vinniefalco for Beast and his guidance for getting this up and
+running.
+
+Thank you Apple for opening up the [Swift](https://github.com/apple/swift/) compiler and 
+IDE facilities. This project would not be possible without this.
+
+Thanks to @Valloric and the YCMD/YouCompleteMe project.