Add "known issue" for quantities sometimes losing their units

This follows up on a comment made by @embray in #1930: that we should document that some functions do not work well with `Quantity`.