adding support for rivers along with unit tests... further added additional backwards compatibility easing
adding documentation for the core operations in the readme