From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124])
	by inbox.dpdk.org (Postfix) with ESMTP id 57796438CE;
	Mon, 15 Jan 2024 12:44:50 +0100 (CET)
Received: from mails.dpdk.org (localhost [127.0.0.1])
	by mails.dpdk.org (Postfix) with ESMTP id 414AC402C9;
	Mon, 15 Jan 2024 12:44:50 +0100 (CET)
Received: from foss.arm.com (foss.arm.com [217.140.110.172])
 by mails.dpdk.org (Postfix) with ESMTP id 77F73402C6
 for <dev@dpdk.org>; Mon, 15 Jan 2024 12:44:48 +0100 (CET)
Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14])
 by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 797292F4;
 Mon, 15 Jan 2024 03:45:34 -0800 (PST)
Received: from [10.1.194.39] (unknown [10.1.194.39])
 by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 71E993F5A1;
 Mon, 15 Jan 2024 03:44:47 -0800 (PST)
Message-ID: <9dc81981-d620-475c-8a8f-ae074e583784@arm.com>
Date: Mon, 15 Jan 2024 11:44:46 +0000
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: [PATCH] dts: improve documentation
Content-Language: en-GB
To: =?UTF-8?Q?Juraj_Linke=C5=A1?= <juraj.linkes@pantheon.tech>
Cc: dev@dpdk.org, Paul Szczepanek <Paul.Szczepanek@arm.com>,
 Thomas Monjalon <thomas@monjalon.net>
References: <20240103125438.182098-1-Luca.Vizzarro@arm.com>
 <CAOb5WZYz_NyNAXEiKoATd5GBCfF+mS_cZAa1QaAAYrWg6PBvHA@mail.gmail.com>
 <07ec0377-396a-46e9-93e4-c7e5133441c5@arm.com>
 <CAOb5WZbtXrsri8v+14y+nEEH_Wa7bSyFc=bpwb3Qo28kMCkwMQ@mail.gmail.com>
From: Luca Vizzarro <Luca.Vizzarro@arm.com>
In-Reply-To: <CAOb5WZbtXrsri8v+14y+nEEH_Wa7bSyFc=bpwb3Qo28kMCkwMQ@mail.gmail.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org

On 15/01/2024 09:36, Juraj Linkeš wrote:
> This wouldn't need to be a hard requirement. It could just be a tool
> that submitters could use as a starting point (which they would
> optionally install and use).

Sorry, forgot to mention that the tool is actually a sphinx plugin, 
which is used through directives in the doc pages. It doesn't actually 
generate rst, but rather renders tables when running sphinx-build.
Otherwise, yeah, it would have been feasible.
> I like mappings [0] and sequences [1], as that is the standard Python
> terminology.

Ack. Sounds good to me. I could also add these links for reference.

> One more thing to like about mappings and sequences, we don't (or
> shouldn't) have to explain those. I think those would work fine on
> both fronts.