Fix slice out of bounds crash

There was crash when we try insert element to full data struct at position i=0
when left neighbour data struct was not full

Fix example signature for Put explanation

clarify documentation

Clean up some of the documentation text for readability.