website/docs: document how long compatibility will be aroung