Added a note for users expecting api compatibility

If there are changes in behavior, a package is *not* a drop-in alternative