doc/: Update ring_buffer.rst to describe new API

Updating the ring_buffer documentation to reflect the new API.

Signed-off-by: Måns Ansgariusson <[email protected]>

Author: Mattemagikern