Mark some methods as internal

[JasonGrace2282]

This is an idea of an implementation for #3792

It defines a decorator that modifies the function's docstring to warn end-users that it is marked as an implementation detail.

Example

TODO

• [x] Figure out why sometimes the decorator does not produce the warning directive