yeah something like   `#do not use, to be deprecated`

alternatively, .add_comment isn't actually too many places in the code base. The only catch I think is that changing it is going to temporarily break a few tests. 
a) If this would be a useful thing to do I'm happy to do it
b) If there are no real gains we leave it with a comment

pick-a-path