I think it's a good practice to also write what can be used/done instead if you deprecate the field... I mean you can write some thing like "From now on you should use this or this to archive the same". From the other hand, "it can be removed at any time" is a self-evident fact for the deprecated stuff. So I don't find this comment very helpful :)