I see a few options forward then:

1. document well
2. open another follow up feature request and merge as is
3. extend this PR to include a warning to the user?

any other option? what would be your take?