Как документировать ownership в современном C++ API?

Типы сами говорят: unique_ptr transfer, shared_ptr share, span/ref borrow, optional отсутствия.

Разбор

• gsl::owner устаревающий стиль.
• Примеры в headers.
• Не сырой T* без доки.
• Clang-tidy checks.

Итог

Тип выражает владение лучше комментария.