Improve ready api
Added docs + example