Re: [PATCH v5 3/5] docs: staging: gpio-rpmsg: gpio over rpmsg bus

Randy Dunlap
2025-11-12T21:18:11Z

On 11/12/25 5:35 AM, Daniel Baluta wrote:
> On Wed, Nov 12, 2025 at 2:59 PM Rob Herring <robh@kernel.org> wrote:
>>
>> On Tue, Nov 04, 2025 at 02:33:13PM -0600, Shenwei Wang wrote:
>>> Describes the gpio rpmsg transport protocol over the rpmsg bus between
>>> the cores.
>>>
>>> Signed-off-by: Shenwei Wang <shenwei.wang@nxp.com>
>>> ---
>>> Documentation/staging/gpio-rpmsg.rst | 202 +++++++++++++++++++++++++++
>>> Documentation/staging/index.rst | 1 +
>>
>> Why is this in staging when none of the drivers are?
>
> I guess that's because remoteproc.rst and rpmsg.rst are in Documentation/staging
> and that's because when converting them from .txt to .rst the author
> didn't know a
> good place where to move them.
>
> Would Documentation/driver-api be a good place for these doc files? I
> can move them
> and then Shenwei place the gpio-rpmsg.rst in the Documentation/driver-api also

Documentation/driver-api/gpio/ if its driver documentation.
Documentation/userspace-api/gpio/ if it user API docs
There is also gpio documentation in Documentation/admin-guide/gpio/ which could
also be appropriate depending on the nature of the document.

--
~Randy