From nobody Thu Nov 6 04:46:12 2025 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4d28lt5BTXz6FqZZ; Thu, 06 Nov 2025 04:46:18 +0000 (UTC) (envelope-from jhb@FreeBSD.org) Received: from smtp.freebsd.org (smtp.freebsd.org [IPv6:2610:1c1:1:606c::24b:4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "smtp.freebsd.org", Issuer "R13" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4d28lt4fsqz44JC; Thu, 06 Nov 2025 04:46:18 +0000 (UTC) (envelope-from jhb@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1762404378; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=f4HpJ0+oo8tia7m8gQc4RF99eWqs1LB5dWd4TjAtDrA=; b=KaCHVc7DM0qrxLs/FEVXVew/gMT7a3qiijPbRT6gg9Z5BVq9p7hPDoanFJfyb+BJDeK1M/ PSpAVPSOC/ocwxCPBSILXFFKTGsJQ3My/msUnCaGQ8iucHJ9avAEZufBG8ulJT8T28WnqS /yE08JGq6wj85N4mok6JFB474+t7gM7tM8Uy/A7aK1poTjVQZg9qTsli0L37IFn4rcAgoF iO/lup65kkVTzHMP47ZgGtR/sgWrfuhyeW2nRL5wx5i9Hs8MsYanNQrJMO7r/3JBwq3wNR VvX89raRcOs4jFsP1VhSOiohNjEUFyquAnB2/1MbtNmbRrHx7pY7Avm2bIKRoA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1762404378; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=f4HpJ0+oo8tia7m8gQc4RF99eWqs1LB5dWd4TjAtDrA=; b=ZQ3tys9bLV6qJdqV06bjM3TN+GDjhlab36dCqhREHmASRMNYAAl4yISl6XmYnC03z5je+V MzsrQ0kF/897juK9fwG4Ui4iCNn7EslHe3X0o5rejVjxi/HM/aGuFbW02F0KwcSa2ZYPSB L16WrBf+VvBu/nyuKMzIg0UUBP1HNfTy4d3WiYbkhmVKyDDwEJnER/SBLfcGNw3f9FEf3x L0iBUZQpvoy3MOHrSqZuBZPU6Gou4lMKct2iQ6P4biIfdeey1eiHeTw1F6t71+u/DNhlzu FhbcDQw/+E2sWAuINghW93ZcMwiAgplKjDftFcSndvBf4SQT0Z7UpSoCvTG76A== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1762404378; a=rsa-sha256; cv=none; b=yhTFfY6VIH2KnZzF2NgL40Oh7Bj+gFFErJB3QQDE3VUp/+g/PbuP1PkOuzLC8LHVffT6nY GHn914ipBRYGB16Hx+e3BpDR75dwDlq+whdlHYtru5A5+Cf2724XPgZHvKBvkI3/Y2qYTe laPGHpnR3wR3L0j++JoMg03T1Wzrqiu4EXx3ClK5IWCtXQlgmov3MvAJYPihytw+Ik8+F7 N+yJQnxkxlJNfsWUG+sO5uXZUhEP7H07muHWlcZI7sB2s2hrKaqFKH2PPsJ+ZG2d9xQgnP Lljo5a2shZbFMqCtOXj5IPxSmL6ZJiaMZ/nmeRZPKD0oicL7Ptxq3b3pG/ZIPQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from [192.168.11.170] (unknown [12.47.130.94]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) (Authenticated sender: jhb) by smtp.freebsd.org (Postfix) with ESMTPSA id 4d28ls2FNCzFrL; Thu, 06 Nov 2025 04:46:16 +0000 (UTC) (envelope-from jhb@FreeBSD.org) Message-ID: <5fcf75df-603e-4a76-82c0-3934406316fc@FreeBSD.org> Date: Wed, 5 Nov 2025 20:46:12 -0800 List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: git: ff18000da3 - main - HW Relnotes: Add nvd to template Content-Language: en-US To: Alexander Ziaee , doc-committers , dev-commits-doc-all References: From: John Baldwin In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 11/5/25 22:57, Alexander Ziaee wrote: > On 2025-11-05 22:10 -05:00 EST, "John Baldwin" wrote: >> On 11/5/25 18:08, Alexander Ziaee wrote: >>> The branch main has been updated by ziaee: >>>> URL: https://cgit.FreeBSD.org/doc/commit/?id=ff18000da31f4135af522f43beb4d0877b024fea >>>> commit ff18000da31f4135af522f43beb4d0877b024fea >>> Author: Alexander Ziaee >>> AuthorDate: 2025-11-05 23:07:39 +0000 >>> Commit: Alexander Ziaee >>> CommitDate: 2025-11-05 23:07:39 +0000 >>>> HW Relnotes: Add nvd to template >>> --- >>> website/archetypes/release/hardware.adoc | 2 ++ >>> 1 file changed, 2 insertions(+) >>>> diff --git a/website/archetypes/release/hardware.adoc b/website/archetypes/release/hardware.adoc >>> index 0a9026c2fd..304641abd1 100644 >>> --- a/website/archetypes/release/hardware.adoc >>> +++ b/website/archetypes/release/hardware.adoc >>> @@ -312,6 +312,8 @@ EISA adapters are not supported. >>> > &hwlist.nda; >>> > +&hwlist.nvd; >>> + >>> &hwlist.ocs_fc; >> >> Hmm, it's not clear to me that nda/nvd are really hardware devices so much as software >> drivers layered on top of a hardware abstraction (NVMe namespaces). We wouldn't list >> vlan(4) support as a distinct hardware feature in a list of NIC devices, and I feel >> like listing da(4) or pass(4) or nda(4) or nvd(4) is similar to vlan(4). In particular, >> you can't hold an nda(4) or vlan(4) (or wlan(4)) in your hand the way you can hold an >> M.2 NVMe device, or a NIC. I think for the hardware notes, what people are interested >> in is which pieces of hardware will work, not necessarily the software abstractions we >> layer on top of them. >> >> Similarly, you wouldn't list mfid(4) for the logical RAID volumes on an mfi(4) controller, >> just that we support mfi(4) controllers. The fact that you can access the RAID volumes >> exported by such a controller is implied by supporting the controller. > > Well, yes, but before I added these, searching the page for a "nvme" only showed ahci bridges and raid controllers. I think that means we need a suitable section in nvme.4 so we can use &hwlist.nvme then? Having both nvd and nda listed back to back seems a bit redundant vs having a good description for nvme(4) that says it supports PCIe NVMe devices I think? -- John Baldwin