Merge pull request #65 from RyanAaronGreen/readme-edits

Edited some of the verbiage on the readme to read more natively.

Author: Łukasz Florczak

README.md

@@ -1,23 +1,23 @@
 # vue-agile
 
-> Carousel component for Vue.js inspired by [Slick](https://github.com/kenwheeler/slick/).<br>
-> More powerful with each version, touch-friendly, written in Vue and Vanilla JS (without jQuery dependency).
+> A carousel component for Vue.js inspired by [Slick](https://github.com/kenwheeler/slick/).<br>
+> Powerful, touch-friendly, and written in Vue and Vanilla JS (without a jQuery dependency).
 
 **[Demo & examples](https://lukaszflorczak.github.io/vue-agile/)**
 
 🤝 Thanks to [Maciej Wach](https://github.com/wachu91) for inventing the name, testing and motivation.
 
 ---
 
-🎉 **After about a year of the last version, I'm happy and excited to inform, that new `v1.0` version is coming soon! Some features I planed in version `v0.4` were for me impossible to realise and I got stuck in it completely. Version [`2.6 of Vue.js`](https://github.com/vuejs/vue/releases/tag/v2.6.0) opened new slots opportunities and now I can return to developing the plugin. I've learned a lot for that time so I also decided to refactor all code – it should be now cleaner and better optimised. Stay tuned!**
+🎉 **After about a year from the last version, I'm happy and excited to inform, that new `v1.0` version is coming soon! Some features I planed in version `v0.4` were for me impossible to realise and I got stuck in it completely. Version [`2.6 of Vue.js`](https://github.com/vuejs/vue/releases/tag/v2.6.0) opened new slots opportunities and now I can return to developing the plugin. I've learned a lot for that time so I also decided to refactor all code – it should be now cleaner and better optimised. Stay tuned!**
 
 ---
 
 ## Important – update from version < `0.3`
 
-**In version `0.3.0`, I removed all styles that are responsible for the appearance of navigation elements** (like dots color and shape, arrows position, etc.). I think most people use their own styles and default styles are completely redundant. If you want to check out these defaults styles, you can find them [here](https://github.com/lukaszflorczak/vue-agile/blob/master/src/Agile.vue#L488).
+**In version `0.3.0`, I removed all styles that are responsible for the appearance of the navigation elements** (like dots color and shape, arrows position, etc.). I think most people use their own styles and default styles are completely redundant. If you want to check out these defaults styles, you can find them [here](https://github.com/lukaszflorczak/vue-agile/blob/master/src/Agile.vue#L488).
 
-**Additionally dots and arrows have been moved from the `.agile__list` to the main `.agile` container.** The layout is the same as in Slick and id should allow for better and more comfortable positioning of these elements.
+**Additionally dots and arrows have been moved from the `.agile__list` to the main `.agile` container.** The layout is the same as in Slick and should allow for and easier time positioning these elements.
 
 ## Installation
 
@@ -88,7 +88,7 @@ Every first-level child of `<agile>` is a new slide.
 
 ## Responsive
 
-To customize responsiveness, I recommend defining desired breakpoint and passing a settings object with the options to modify inside **options**.
+To customize responsiveness, I recommend defining your desired breakpoints and passing a settings object with your modification options inside **options**.
 
 ### Example
 
@@ -128,12 +128,12 @@ data () {
 
 ## Arrows
 
-By default carousel contains SVG arrows. You can change them using CSS or `prevArrow` & `nextArrow` parameters. 
+By default a carousel contains SVG arrows. You can change them by using CSS or with the `prevArrow` & `nextArrow` parameters. 
 
 There are two important things:
 
-1. You should put your SVG/HTML code in one line, without new line chars etc.
-2. You should define arrows code as variables in `data()`.
+1. Your SVG/HTML code should all be one line (no linebreaks, line chars, etc.)
+2. You should define each of your arrows' code as variables within `data()`.
 
 ### Example
 
@@ -148,16 +148,16 @@ export default {
     data () {
         return {
             left: '<svg x="0px" y="0px" viewBox="0 0 24 24"><path d="M16.2,21c0.3,0,0.5-0.1,0.7-0.3c0.4-0.4,0.4-1,0-1.4L9.6,12L17,4.7c0.4-0.4,0.4-1,0-1.4c-0.4-0.4-1-0.4-1.4,0L6.8,12l8.8,8.7C15.7,20.9,16,21,16.2,21z"/></svg>',
-            right: '<svg x="0px" y="0px" viewBox="0 0 24 24"><path d="M7.8,21c-0.3,0-0.5-0.1-0.7-0.3c-0.4-0.4-0.4-1,0-1.4l7.4-7.3L7,4.7c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l8.8,8.7l-8.8,8.7C8.3,20.9,8,21,7.8,21z"/></svg>'
+            right: '<svg x="0px" y="0px" viewBox="0 0 24 24"><path d="M7.8,21c-0.3,0-0.5-0.1-0.7-0.3c-0.4-0.4-0.4-1,0-1.4l7.4-7.3L7,4.7c-0.4-0.4-0.4-1,0-1.4s1-0.4 1.4,0l8.8,8.7l-8.8,8.7C8.3,20.9,8,21,7.8,21z"/></svg>'
         }
     }
 }
 ```
 ## `v-if` & `v-show`
 
-If you have dynamically loaded slides, use `v-if` to show carousel when slides will be ready. Using `v-if` is also recommended in other situations if you want to hide/show the slideshow.
+If you have slides being dynamically loaded, use `v-if` to show the carousel after the slides are ready. Using `v-if` is also recommended in other situations if you want to hide/show the slideshow.
 
-If for some reason you need to use `v-show`, it's also possible, but you have to use an additional parameter `show` with the same value as for the `v-show`.
+It is also possible to use `v-show`, but you have to use the additional parameter `show` with the same value as what's in `v-show`.
 
 ### Example
 ``` html
@@ -176,7 +176,7 @@ toggleAgile () {
 
 ## SSR Support
 
-The component uses browser specific attributes (like `window` and `document`). It is necessary, so probably the only option is to run vue-agile only on the client-side. It was tested on [nuxt v1.0.0-rc7](https://github.com/nuxt/nuxt.js/releases/tag/v1.0.0-rc7) and works fine.
+The component uses browser specific attributes (like `window` and `document`). Unfortunately, it is necessary -- so as of now, the only option is to run vue-agile solely on the client-side. It was tested on [nuxt v1.0.0-rc7](https://github.com/nuxt/nuxt.js/releases/tag/v1.0.0-rc7) and works fine.
 
 ### Example
 ```js