README.md in ruby_slides-1.2.0 vs README.md in ruby_slides-1.2.1

@@ -22,11 +22,109 @@
 
 ```ruby
 gem 'ruby_slides', git: "https://github.com/danielsousaio/ruby_slides.git"
 ```
 
-## Usage
+## Getting started
 
+
+Get started by creating a new object
+
+```ruby
+@presentation =  RubySlides::Presentation.new
+```
+
+RubySlides offer various types of slide as described below. If you would like
+to see an example of a powerpoint generated with RubySlides take a look at the
+powerpoint in the example folder. That's the result of running the spec.
+
+
+### Introduction Slide
+
+```ruby
+title = "Hello Universe!"
+subtitle = "Powerpoints with ruby"
[e-mail]_slide title, subtitle
+```
+
+### Textual Slide
+
+```ruby
+textual_title = "Textual Slide"
+textual_items = ["Item 1", "Item 2", "Item 3"]
[e-mail]_slide textual_title, textual_items
+```
+
+### Pictorial Slide
+
+```ruby
+pictorial_title = "Image Slide"
+picture_path = "example/ruby.png"
[e-mail]_slide pictorial_title, picture_path
+```
+
+### Pictorial with coordinates
+
+```ruby
+picture_coords = { x: 550 * 12700, y: 30 * 12700,     # Picture Position
+                  cx: 80 * 12700, cy: 60 * 12700 }    # Picture Sizing
[e-mail]_slide pictorial_title, picture_path, picture_coords
+```
+
+### Text Picture Slide
+
+```ruby
+text_picture_title = "Text Picture Slide"
+text_picture_content = [
+    "Picture size: 2MB", 
+    "Picture author: Unknown Rubyist"
+  ]
[e-mail]_picture_slide text_picture_title, picture_path,
+                                 text_picture_content
+```
+
+### Picture Description Slide
+
+```ruby
+picture_description_title = "Picture Description Slide"
+picture_description_content = [
+    "Picture description, long text",
+    "Additional information"
+  ]
[e-mail]_description_slide picture_description_title,
+                                    picture_path,
+                                    picture_description_content
+```
+
+### Table Slide
+
+```ruby
+table_title = "Table Slide"
+table_series = [
+  ["HeaderA", "HeaderB"],
+  ["ValueA", "ValueB"]
+]
[e-mail]_slide table_title, table_series
+```
+
+### Chart Slide
+
+```ruby
+chart_title = "Chart Slide"
+chart_series = [
+    {
+      column: "Col1",
+      rows:   ["A", "B", "C", "D"],
+      values: ["1", "3", "5", "7"]
+    },
+    {
+      column: "Col2",
+      rows:   ["A", "B", "C", "D"],
+      values: ["2", "4", "6", "8"]
+    }
+  ]
[e-mail]_slide chart_title, chart_series
+```
 
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.