README.md in symbiont-0.2.1 vs README.md in symbiont-0.3.0
- old
+ new
@@ -1,65 +1,57 @@
-Symbiont [](http://travis-ci.org/jnyman/symbiont) [](https://gemnasium.com/jnyman/symbiont)
-========
-
-Description
------------
-
-The Symbiont gem is designed to provide an open framework for running automated tests against a browser using popular web testing interfaces.
-
-Right now the best information on the purpose of this project and how it works can be found on [my Symbiont-tagged blog posts](http://testerstories.com/?cat=16).
-
-
-Installation
-------------
-
-Add this line to your application's Gemfile:
-
- gem 'symbiont'
-
-And then execute:
-
- $ bundle
-
-Or install it yourself as:
-
- $ gem install symbiont
-
-
-Using Symbiont
---------------
-
-Check out the [Symbiont Wiki](https://github.com/jnyman/symbiont/wiki) for details on how to use Symbiont.
-
-
-Why call it Symbiont?
----------------------
-
-A "symbiont" is an organism in a symbiotic (mutually beneficial) relationship. Some of these relationships are called _obligate_, which means that both organisms need each other in order to survive. Other such relationships are called _facultative_, meaning that both organisms don't strictly need each other to survive, but they stand a better chance if they do.
-
-Symbiotic relationships include associations in which one organism lives on another organism -- _ectosymbiosis_ -- or where one organism lives inside the other -- _endosymbiosis_.
-
-So, with that bit of context, think of this gem as a facultative, endosymbiotic organism that lives within your test logic, giving it strength and sustenance.
-
-
-Contributing
-------------
-
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Added some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
-
-
-Credits
--------
-
-Thanks to Jeff Morgan (http://www.cheezyworld.com/) for his page-object gem, Alister Scott (http://watirmelon.com) for his watir-page-helper gem, and Nat Ritmeyer (http://www.natontesting.com/) for his SitePrism gem. I learned a lot from analyzing their code and working to craft my own solution around theirs. Rather than fork their projects, my changes were systemic enough to warrant creating a new project.
-
-
-Copyright
----------
-
-See the LICENSE file for details.
-
-In short, Lucid is under an MIT license. Since I'm borrowing from many other people, just as they borrowed from many other people before them, I'm just establishing I wrote _this_ particular version. (If nothing else, this means you know who to blame.)
+# Symbiont
+
+[](http://badge.fury.io/rb/symbiont)
+[](http://travis-ci.org/jnyman/symbiont)
+[](https://coveralls.io/r/jnyman/symbiont?branch=master)
+[](https://codeclimate.com/github/jnyman/symbiont)
+[](https://gemnasium.com/jnyman/symbiont)
+
+Symbiont provides a semantic domain-specific language that can be used to construct a fluent interface for test execution libraries. The initial focus will be on using the [watir-webdriver](https://github.com/watir/watir-webdriver) API as the underlying driver library.
+
+[](https://gitter.im/jnyman/symbiont)
+[](https://coderwall.com/jnyman)
+
+
+## Installation
+
+You can use Symbiont as part of another project, in which case you can add the following to your Gemfile:
+
+ gem 'symbiont'
+
+And then execute:
+
+ $ bundle
+
+You can also install Symbiont just as you would any other gem:
+
+ $ gem install symbiont
+
+## Usage
+
+Instructions on how to use Symbiont will be available as the interface is defined. You can check out the [Symbiont test script](https://github.com/jnyman/symbiont/blob/master/test/symbiont-script.rb) for an idea of how the library can be interacted with. Do note that the test script requires a local copy of [Dialogic](https://github.com/jnyman/dialogic) to be running. To execute the test script:
+
+ $ rake test:script
+
+## Why call it Symbiont?
+
+A "symbiont" is an organism in a symbiotic (mutually beneficial) relationship. Some of these relationships are called _obligate_, which means that both organisms need each other in order to survive. Other such relationships are called _facultative_, meaning that both organisms don't strictly need each other to survive, but they stand a better chance if they do.
+
+Symbiotic relationships include associations in which one organism lives on another organism -- _ectosymbiosis_ -- or where one organism lives inside the other -- _endosymbiosis_.
+
+So, with that bit of context, think of this library as a facultative, endosymbiotic organism that lives within your test logic, giving it strength and sustenance.
+
+## Contributing
+
+1. [Fork the project](http://gun.io/blog/how-to-github-fork-branch-and-pull-request/).
+2. Create a feature branch. (`git checkout -b my-new-feature`)
+3. Commit your changes. (`git commit -am 'new feature'`)
+4. Push the branch. (`git push origin my-new-feature`)
+5. Create a new [pull request](https://help.github.com/articles/using-pull-requests).
+
+## Credits
+
+Thanks to Jeff Morgan ([http://www.cheezyworld.com/](http://www.cheezyworld.com/)) for his [page-object](https://github.com/cheezy/page-object) gem, Alister Scott ([http://watirmelon.com](http://watirmelon.com)) for his [watir-page-helper](https://github.com/alisterscott/watir-page-helper) gem, Alex Rodionov ([(http://p0deje.blogspot.com/](http://p0deje.blogspot.com/)) for his [watirsome](https://github.com/p0deje/watirsome) gem, and Nat Ritmeyer ([http://www.natritmeyer.com/](http://www.natritmeyer.com/)) for his [SitePrism](https://github.com/natritmeyer/site_prism/) gem.
+
+## Copyright
+
+Symbiont is distributed under the MIT license. See the [LICENSE](https://github.com/jnyman/symbiont/blob/master/LICENSE.txt) file for details.