Documentation/SmartPointers.md mentions make<>(), adopt_own(), adopt_own_if_nonnull(), make_ref_counted<>(), tadopt_ref(), adopt_ref_if_nonnull<>(), but it does not mention adopt_nonnull_own_or_enomem noradopt_nonnull_ref_or_enomem().

(It does mention try_make<>() and try_make_ref_counted<>(), which wrap the _or_enomem() functions.)

It also doesn't mention when to use which variant. (I'm guessing newer code should use the enomem variant.)

Separately, Documentation/Patterns.md has a section on "Fallible Constructors" which does mention adopt_nonnull_own_or_enomem but not the more convenient try_make<>() wrapper around it. (It also doesn't mention refptrs.)

Suggestions:

1. Update SmartPointers.md to mention the _enomen functions, and rewrite it a bit to say "new code should use the ErrorOr<> versions, see also 'Fallible Constructors' Patterns.md"
2. The section in Patterns.md should use try_make instead of what it currently uses

(I'm not sure those are the right suggestions, though.)

@awesomekling @BertalanD @timschumi @IdanHo