UPD: Documentation update, including warning about backwards compatibility

[skip ci]