I think we should also add a paragraph that states:

> A class or module is marked with `:nodoc:` to indicate that all methods are internal API and should never be used directly.