Standard docs about if the disposable is created or cached

[JohanLarsson]

namespace RoslynSandbox
{
    using System;

    public static class Foo
    {
        /// <summary>
        /// ...
        /// </summary>
        /// <returns>A new instance of <see cref="Disposable"/> that the caller is responsible for disposing.</returns>
        public static IDisposable Create() => new Disposable();
    }
}

And

namespace RoslynSandbox
{
    using System;

    public static class Foo
    {
        private static readonly IDisposable Instance = new Disposable();

        /// <summary>
        /// ...
        /// </summary>
        /// <returns>A cached instance of <see cref="Disposable"/> that the caller must not dispose.</returns>
        public static IDisposable Bar() => Instance;
    }
}