We probably can try something like adding :meta private: to the doc string instead. Even though it's a sphinx thing, I think this should be sufficient

Originally posted by @Lee-W in #1466 (comment)