README.md in kurento_rails-0.1.0 vs README.md in kurento_rails-0.1.1
- old
+ new
@@ -1,11 +1,9 @@
# KurentoRails
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/kurento_rails`. To experiment with that code, run `bin/console` for an interactive prompt.
+KurentoRails is a gem designed to make integrating kurento media server and rails applications easier. We provide a javascript library to provide easy access to kurento's video streaming functionality.
-TODO: Delete this and the text above, and describe your gem
-
## Installation
Add this line to your application's Gemfile:
```ruby
@@ -18,23 +16,39 @@
Or install it yourself as:
$ gem install kurento_rails
+
+For reasons that I'm not entirely sure about and don't have time to investigate just yet, the gem isn't correctly bundling websocket-rails in as well on some systems. If your app won't launch after you complete the steps listed below in usage, try fixing it by just adding websocket-rails to your gemfile as well, then re-running bundle.
+
## Usage
-TODO: Write usage instructions here
+After installation, run the following command
-## Development
+```ruby
+rails g kurento_rails:install
+```
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+This will copy a number of files into your project. These are:
+- config/events.rb: This file is responsible for routing websockets events to the correct controller and action
+- app/controllers/kurento_controller.rb: This controller is used for serving html pages that interact with kurento. It should at least be a step in the right direction for you.
+- app/controllers/kurento_websockets_controller.rb: This controller is responsible for most of the internal streaming logic. The javascript client library interacts heavily with this controller
+- app/assets/javascripts/kurento-rails-js: This is the javascript client library. kurento-rails.js is the main code for the library. The other libraries included here are dependencies and should also be included.
+- db/migrations/{timestamp}-create_video_streams.rb: This is the active record migration for the video stream model.
+- app/models/kurento_rails_video_stream.rb: This is the video stream model
+- app/views/kurento: This folder contains the views associated with the kurento controller. I assume that you're using slim, because slim is fantastic, but if you're not, you can just edit the extensions on these.
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+finally, you'll need to migrate the database
+```ruby
+rake db:migrate
+```
+After this, the installation process should be complete.
+
## Contributing
-Bug reports and pull requests are welcome on GitHub at https://github.com/andrewls/kurento-rails. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](contributor-covenant.org) code of conduct.
-
+Bug reports and pull requests are welcome on GitHub at https://github.com/andrewls/kurento-rails.
## License
The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).