README.md in probedock-rspec-0.6.0 vs README.md in probedock-rspec-0.7.0

@@ -1,52 +1,45 @@
-# Probe Dock RSpec
+# RSpec Probe for Probe Dock
 
-**RSpec probe for [Probe Dock](https://github.com/probedock/probedock).**
+**RSpec formatter to publish test results to [Probe Dock](https://github.com/probedock/probedock).**
 
 [![Gem Version](https://badge.fury.io/rb/probedock-rspec.svg)](http://badge.fury.io/rb/probedock-rspec)
 [![Dependency Status](https://gemnasium.com/probedock/probedock-rspec.svg)](https://gemnasium.com/probedock/probedock-rspec)
 [![Build Status](https://secure.travis-ci.org/probedock/probedock-rspec.svg)](http://travis-ci.org/probedock/probedock-rspec)
 [![Coverage Status](https://coveralls.io/repos/probedock/probedock-rspec/badge.svg)](https://coveralls.io/r/probedock/probedock-rspec?branch=master)
 [![License](https://img.shields.io/github/license/probedock/probedock-rspec.svg)](LICENSE.txt)
 
-## Requirements
+* [Requirements](#requirements)
+* [Installation](#installation)
+* [Usage](#usage)
+* [Contributing](#contributing)
 
-* RSpec 3+
 
-## Installation
 
-In your Gemfile:
+<a name="requirements"></a>
+## Requirements
 
-```rb
-gem 'probedock-rspec', '~> 0.6.0'
-```
+* Ruby 2+
+* RSpec 3+
 
-Manually:
 
-    gem install probedock-rspec
 
-## Usage
+<a name="installation"></a>
+## Installation
 
-If you haven't done it already, follow the [setup procedure](#setup) below.
+Add it to your Gemfile:
 
-To track a test with a Probe Dock test key, use RSpec metadata:
-
 ```rb
-it "should work", probedock: { key: 'abcdefghijkl' } do
-  expect(true).to be(true)
-end
-
-it(nil, probedock: { key: 'bcdefghijklm' }){ should validate_presence_of(:name) }
+gem 'probedock-rspec', '~> 0.7.0'
 ```
 
-<a name="setup"></a>
-## Setup
+Then run `bundle install`.
 
-You must first set up the configuration file(s) for the project.
+If you haven't done so already, set up your Probe Dock configuration file(s).
 This procedure is described here:
 
-* [Probe Setup Procedure](https://github.com/probedock/probedock-clients#setup-procedure)
+* [Probe Setup Procedure](https://github.com/probedock/probedock-probes#setup)
 
 You must then enable the client in your spec helper file (e.g. `spec/spec_helper.rb`).
 
 ```yml
 require 'probedock-rspec'
@@ -58,18 +51,44 @@
 end
 ```
 
 The next time you run your test suite, the RSpec probe will send the results to your Probe Dock server.
 
+
+
+<a name="usage"></a>
+## Usage
+
+To track a test with a Probe Dock test key, use RSpec metadata:
+
+```rb
+it "should work", probedock: { key: 'abcd' } do
+  expect(true).to be(true)
+end
+
+it(nil, probedock: { key: 'bcde' }){ should validate_presence_of(:name) }
+```
+
+You may also define a category, tags and tickets for a test like this:
+
+```rb
+it "should work", probedock: { key: 'cdef', category: 'Integration', tags: %w(user-registration validation), tickets: %w(JIRA-1000 JIRA-1012) } do
+  expect(2).to be < 3
+end
+```
+
+
+
 ## Contributing
 
 * [Fork](https://help.github.com/articles/fork-a-repo)
 * Create a topic branch - `git checkout -b my_feature`
 * Push to your branch - `git push origin my_feature`
 * Create a [pull request](http://help.github.com/pull-requests/) from your branch
 
 Please add a [changelog](CHANGELOG.md) entry with your name for new features and bug fixes.
 
+
+
 ## License
 
-Probe Dock RSpec is licensed under the [MIT License](http://opensource.org/licenses/MIT).
-See [LICENSE.txt](LICENSE.txt) for the full license.
+**probedock-rspec** is licensed under the [MIT License](http://opensource.org/licenses/MIT).