Previous example:

julia> something(Some(1), nothing)
1

PR example:

julia> typeof(something(nothing, Some(nothing)))
Nothing

The previous example this PR replaces was a potentially confusing and nonsensical use of Some with something.

(AFAIU from the docs), The sole purpose of Some is to distinguish a non-value nothing from a value nothing (presumably with the use of something). Therefore, a literal Some(1) is not an informative example, since an unwrapped 1 would also be returned by something (i.e. the Some wrapper in that example does not change the result).

The new example is a clearer way of showing how something and Some interact.