README.md in nutcracker-web-0.0.2 vs README.md in nutcracker-web-0.0.3
- old
+ new
@@ -1,15 +1,21 @@
Nutcracker Web
=============
-[Nutcracker](https://github.com/kontera-technologies/nutcracker) web interface plugin
+[Nutcracker](https://github.com/kontera-technologies/nutcracker) web interface plugin<br/>
+<a href="https://rubygems.org/gems/nutcracker-web"><img src=https://fury-badge.herokuapp.com/rb/nutcracker-web.png></a>
-<img src="https://github.com/kontera-technologies/nutcracker-web/raw/master/pics/pic1.png"/></br>
-<img src="https://github.com/kontera-technologies/nutcracker-web/raw/master/pics/pic2.png"/></br>
<img src="https://github.com/kontera-technologies/nutcracker-web/raw/master/pics/pic3.png"/></br>
-<img src="https://github.com/kontera-technologies/nutcracker-web/raw/master/pics/pic4.png"/></br>
+### Disclaimer
+this project is still in its early stages, so things could be a little buggy, if you find one, feel free to [report](https://github.com/kontera-technologies/nutcracker-web/issues) it.
+Also nutcracker-web only supports Redis instances for now.
+
+### Dependencies
+- Ruby 1.9+
+- [nutcracker-ruby](https://github.com/kontera-technologies/nutcracker)
+
### Installation
add this to your Gemfile
```
gem 'nutcracker-web'
```
@@ -18,39 +24,55 @@
```
$ bundle install
```
### Usage
-example app
```ruby
require 'nutcracker'
require 'nutcracker/web'
# Start nutcracker
nutcracker = Nutcracker.start(config_file: 'cluster.conf')
# Start the web service on port 1234 using Webrick
-nutcracker.use(:graphite, Port: 1234)
+nutcracker.use(:web, Port: 1234)
# Sleeping....
nutcracker.join
```
-`Nutcracker-Web` takes default [Rack](https://github.com/rack/rack) [options](https://github.com/rack/rack/blob/master/lib/rack/server.rb#L187..L199)
+you can pass default [Rack](https://github.com/rack/rack) [options](https://github.com/rack/rack/blob/master/lib/rack/server.rb#L187..L199) to `Nutcracker#use` ( like :Host, :server etc)
### Custom Webserver
-default webserver is `Webrick`, to use a different one, like [thin](http://code.macournoyer.com/thin/):
+to use a different webserver like [thin](http://code.macournoyer.com/thin/)
-```
-$ gem install thin
-```
-
-tell `Nutcracker-Web` to use it
```ruby
require 'nutcracker'
require 'nutcracker/web'
require 'thin'
nutcracker = Nutcracker.start(config_file: 'cluster.conf')
-nutcracker.use(:graphite, Port: 1234, server: :thin)
+nutcracker.use(:web, Port: 1234, server: :thin)
nutcracker.join
```
+
+### Developer
+to run nutcracker-web with stub data
+- `bundle install`
+- run the `rackup` command to start the service.
+- edit `example.json`.
+- client Backbone app is under `assets` and the Sinatra backend is under the `lib` directory.
+
+### Packaging & Testing
+- `rake compile` : compile the assets into a single application.{js,css} file under the public directory
+- `rake build` : compile the assets & builds a new gem
+- `rake test` : runs the jasmine tests suite
+
+### Warranty
+This software is provided “as is” and without any express or implied warranties, including, without limitation, the implied warranties of merchantability and fitness for a particular purpose.
+
+### More PNGs
+<img src="https://github.com/kontera-technologies/nutcracker-web/raw/master/pics/pic1.png"/></br>
+<hr>
+<img src="https://github.com/kontera-technologies/nutcracker-web/raw/master/pics/pic2.png"/></br>
+<hr>
+<img src="https://github.com/kontera-technologies/nutcracker-web/raw/master/pics/pic4.png"/></br>
\ No newline at end of file