maybe put this in a `.. note::` ?