Improves the readme file
Some refactoring. Starts to prepare small helper functions that will be
turned into private methods via namespace later on. They make the
functions better to read and will contain repetitive used code.
Updates namespace and documentation