initial attempt to make better readme

it is actually even more tricky as default parameter mean, that you can call it from perl, just cannot use default parameter. I will try to mention that if calls is expected only from ruby no publish is needed and can be used all ruby features.