Update README.md

Author: thk2b

README.md

@@ -1,5 +1,3 @@
-🚧 At this stage, this project is not unit-tested but works as expected. Minor optimizations are planned. Use with caution. 🚧
-
 # autoscroll-react 
 
 Autoscroll a react component
@@ -23,7 +21,7 @@ class MyList extends React.Component {
     render(){
         const { items, ...props } = this.props
         return (
-            <ul { ...props } >{ // You MUST pass down props
+            <ul { ...props } >{ //  ⚠️ You MUST pass down props ⚠️
                 items.map(
                     item => <Item 
                         key={ item.id } 
@@ -41,7 +39,19 @@ export default Autoscroll(MyList)
 `Autoscroll(Component)`: returns the passed component without any additional markup.
 It scrolls the root node rendered by the component to the bottom whenever it updates, but not if the user has scrolled up.
 
-⚠️ You must Explicitly pass down props to the wrapped component. ⚠️
+## ⚠️  caveats ⚠️ 
+
+- You must Explicitly pass down props to the wrapped component. This is so an event listener can be attached. This means you can also pass down your own props to the wrapped component
+- The wrapped component must be a Class-based component, not a functional one, because `Autoscroll` uses a `ref`.
+- This package is agnostic about any CSS you use. However., it requires that you provide the adequate CSS to make the wrapped component have a scroll bar. (ie. `overflow-y:scroll;` and a set `height`)
+
+## options
+
+`Autoscroll(Component, { isScrolledDownThreshold: 150 /*default*/})`
+
+The `isScrolledDownThreshold` option is used when determining whether the user has scrolled back to the bottom. If the element's `scrollBottom` is within `isScrolledDownThreshold`px of the maximum scroll (`scrollHeight`), the component will scroll down on the next updates. 
+This option exists because scrolling almost all the way down, but not entirely, can be interpreted as a sign that the user intends to see the bottom of the list. 
+
 
 ## Build