initial attempt to make better readme

Maybe we should mention the other implication of direct ruby-to-ruby calling, that you can use ruby-specific features like keyword params. We already use it at least here https://github.com/yast/yast-network/blob/review_141001_autoyast_do_not_overwrite_firewall_settings/src/modules/Lan.rb#L266