Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Date:   Tue, 9 Aug 2022 09:50:18 +0200
From:   Borislav Petkov <bp@alien8.de>
To:     Paul Menzel <pmenzel@molgen.mpg.de>
Cc:     medadyoung@gmail.com, KWLIU@nuvoton.com, tony.luck@intel.com,
        rric@kernel.org, benjaminfair@google.com,
        linux-edac@vger.kernel.org, KFTING@nuvoton.com,
        avifishman70@gmail.com, venture@google.com,
        openbmc@lists.ozlabs.org, JJLIU0@nuvoton.com, ctcchien@nuvoton.com,
        tali.perry1@gmail.com, devicetree@vger.kernel.org,
        robh+dt@kernel.org, james.morse@arm.com, YSCHU@nuvoton.com,
        mchehab@kernel.org, linux-kernel@vger.kernel.org,
        tmaimon77@gmail.com
Subject: Re: Referencing non-public datasheets in commit messages (was:
 [PATCH v12 3/3] EDAC: nuvoton: Add NPCM memory controller driver)
Message-ID: <YvIRusXsZvdiFRzS@zn.tnic>
References: <20220610084340.2268-1-ctcchien@nuvoton.com>
 <20220610084340.2268-4-ctcchien@nuvoton.com>
 <YrDIimW0gW1j03WG@zn.tnic>
 <6d1576c9-f105-2aff-4497-2c2e7bed2f3b@molgen.mpg.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
In-Reply-To: <6d1576c9-f105-2aff-4497-2c2e7bed2f3b@molgen.mpg.de>
Precedence: bulk

On Tue, Aug 09, 2022 at 08:42:29AM +0200, Paul Menzel wrote:
> Maybe it could be denoted, that is not public (and also the version), but
> even mentioning non-public datasheets is useful, as they could be made
> public in the future, and allows everyone to contact people with access to
> these datasheets to take a look into the specific datasheet.

If you're going to contact people to get you certain information, you
don't need the datasheet - you simply need to ask the question.

But whatever, if a document is mentioned, the text should state that it
is not public so that people are aware not to go looking for it. Or, if
it is public, how to find it.

And no, a company website URL is not a good idea because those change
pretty frequently in practice. Uploading to our bugzilla and adding the
link to it is much better.

Thx.

-- 
Regards/Gruss,
    Boris.

https://people.kernel.org/tglx/notes-about-netiquette