readme driven developing the api to inform where te call took place
writing deprecation warnings to the `$stderr`
working usage examples are allways welcome