Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
MIME-Version: 1.0
References: <cover.1586961793.git.mchehab+huawei@kernel.org>
In-Reply-To: <cover.1586961793.git.mchehab+huawei@kernel.org>
From:   Rob Herring <robh+dt@kernel.org>
Date:   Mon, 4 May 2020 22:38:37 -0500
Message-ID: <CAL_JsqJxKoe0rk_JT1KO38gAcgw6nLVqQM65urc_aOYjXEb55g@mail.gmail.com>
Subject: Re: [PATCH v3 00/12] Convert some DT documentation files to ReST
To:     Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Cc:     Linux Doc Mailing List <linux-doc@vger.kernel.org>,
        "linux-kernel@vger.kernel.org" <linux-kernel@vger.kernel.org>,
        Jonathan Corbet <corbet@lwn.net>,
        Martin Blumenstingl <martin.blumenstingl@googlemail.com>,
        "David S. Miller" <davem@davemloft.net>,
        Alexandre Belloni <alexandre.belloni@bootlin.com>,
        Joe Perches <joe@perches.com>,
        Pantelis Antoniou <pantelis.antoniou@konsulko.com>,
        Kevin Hilman <khilman@baylibre.com>,
        Neil Armstrong <narmstrong@baylibre.com>,
        Alex Shi <alex.shi@linux.alibaba.com>,
        Jianxin Pan <jianxin.pan@amlogic.com>,
        Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
        Lee Jones <lee.jones@linaro.org>,
        Christian Hewitt <christianshewitt@gmail.com>,
        Federico Vaga <federico.vaga@vaga.pv.it>,
        Nicolas Ferre <nicolas.ferre@microchip.com>,
        Konstantin Ryabitsev <konstantin@linuxfoundation.org>,
        Andy Whitcroft <apw@canonical.com>, devicetree@vger.kernel.org,
        Harry Wei <harryxiyou@gmail.com>,
        Jacob Huisman <jacobhuisman@kernelthusiast.com>,
        Frank Rowand <frowand.list@gmail.com>
Content-Type: text/plain; charset="UTF-8"
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk

On Wed, Apr 15, 2020 at 9:45 AM Mauro Carvalho Chehab
<mchehab+huawei@kernel.org> wrote:
>
> While most of the devicetree stuff has its own format (with is now being
> converted to YAML format), some documents there are actually
> describing the DT concepts and how to contribute to it.
>
> IMHO, those documents would fit perfectly as part of the documentation
> body, as part of the firmare documents set.
>
> This patch series manually converts some DT documents that, on my
> opinion, would belong to it.
>
> If you want to see how this would show at the documentation body,
> a sneak peak of this series (together with the other pending
> doc patches from me) is available at:
>
>         https://www.infradead.org/~mchehab/kernel_docs/devicetree/index.html
>
> -
>
> v3:
>    - rebased on the top of next-20200414
>
> Mauro Carvalho Chehab (12):
>   docs: dt: add an index.rst file for devicetree
>   docs: dt: convert usage-model.txt to ReST
>   docs: dt: usage_model.rst: fix link for DT usage
>   docs: dt: convert booting-without-of.txt to ReST format
>   docs: dt: convert changesets to ReST
>   docs: dt: convert dynamic-resolution-notes.txt to ReST
>   docs: dt: convert of_unittest.txt to ReST
>   docs: dt: convert overlay-notes.txt to ReST format
>   docs: dt: minor adjustments at writing-schema.rst
>   docs: dt: convert ABI.txt to ReST format
>   docs: dt: convert submitting-patches.txt to ReST format
>   docs: dt: convert writing-bindings.txt to ReST

I've applied all but patch 4 as I'm working on just removing it.

Rob