Update README.md

Author: drinking-code

README.md

@@ -2,8 +2,9 @@
 
 *for HTML divs in React.js*
 
-`react-round-div` makes your rounded rectangles look smoother for a more pleasant feel. With a simple and easy
-integration into your code you have to do almost nothing to up the style of your project.
+`react-round-div` makes your rounded rectangles look smoother for a more pleasant feel. The package
+weighs [just under 10KB](#size) and has an almost "plug and play"-integration into your code, so that you have to do
+next to nothing to up the style of your project.
 
 Here is a very clear demonstration of these smooth corners:
 
@@ -14,6 +15,7 @@ Here is a very clear demonstration of these smooth corners:
     - [Options](#options)
         - [`dontConvertShadow`](#dontconvertshadow)
 - [Things to note & caveats](#things-to-note--caveats)
+    - [Intended differences to the html `<div>`](#intended-differences-to-the-html-div)
     - [webpack](#webpack)
 
 ## Installation
@@ -67,20 +69,24 @@ your `box-shadow`s, add the `dontConvertShadow` option:
 
 ## Things to note & caveats
 
-This package is still in the starting blocks, so for now borders are only supported in the `solid` style and some
-transitions, and animations on the div may not work properly.
+This package is still in the starting blocks, some cases where it might not behave as expected. For example, some border
+styles are not rendered correctly, and some transitions and animations on the div may not work properly.
 
-There are a couple of css properties, that you can't reliably set with `RoundDiv`:
+There are a couple of css properties, that you can't reliably set _inline_ with `RoundDiv`:
 
 - the `background` property and all the properties it is a shorthand for
-- `border-color`
+- the `border`, `border-image`, and all the properties they are a shorthand for
 - `box-shadow`
 - `filter`, if you haven't set [`dontConvertShadow`](#dontconvertshadow)
 
-You shouldn't set these properties inline. Instead, set them in a stylesheet. This may change in future versions.  
-The `filter` property in particular will not work at all, if you have set a `box-shadow` AND have not
+You shouldn't set these properties inline. Instead, set them in a stylesheet. This behaviour may change in future
+versions. The `filter` property in particular will only not work, if you have set a `box-shadow` AND have not
 set [`dontConvertShadow`](#dontconvertshadow). This may also change in future versions.
 
+### Intended differences to the html `<div>`
+
+Unlike the html `<div>`, `RoundDiv` still rounds the corners of borders of there is a border image set. This looks great with gradients, but might clash with the use of actual images as borders.
+
 ### webpack
 
 If you use a preprocessor like webpack (which you most likely are), you need to turn off or polyfill the node