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

[Shenwei Wang]

> -----Original Message-----
> From: Randy Dunlap <rdunlap at infradead.org>
> Sent: Wednesday, November 12, 2025 3:18 PM
> To: Daniel Baluta <daniel.baluta at gmail.com>; Rob Herring <robh at kernel.org>
> Cc: Shenwei Wang <shenwei.wang at nxp.com>; Bjorn Andersson
> <andersson at kernel.org>; Mathieu Poirier <mathieu.poirier at linaro.org>;
> Krzysztof Kozlowski <krzk+dt at kernel.org>; Conor Dooley
> <conor+dt at kernel.org>; Shawn Guo <shawnguo at kernel.org>; Sascha Hauer
> <s.hauer at pengutronix.de>; Jonathan Corbet <corbet at lwn.net>; Linus Walleij
> <linus.walleij at linaro.org>; Bartosz Golaszewski <brgl at bgdev.pl>; Pengutronix
> Kernel Team <kernel at pengutronix.de>; Fabio Estevam <festevam at gmail.com>;
> Peng Fan <peng.fan at nxp.com>; linux-remoteproc at vger.kernel.org;
> devicetree at vger.kernel.org; imx at lists.linux.dev; linux-arm-
> kernel at lists.infradead.org; linux-kernel at vger.kernel.org; linux-
> doc at vger.kernel.org; dl-linux-imx <linux-imx at nxp.com>
> Subject: [EXT] Re: [PATCH v5 3/5] docs: staging: gpio-rpmsg: gpio over rpmsg bus
> On 11/12/25 5:35 AM, Daniel Baluta wrote:
> > On Wed, Nov 12, 2025 at 2:59 PM Rob Herring <robh at 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 at 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.
> 

Thanks Randy!

Do we have a final decision on where to place this document?
My thought is that Documentation/driver-api/gpio/ seems more appropriate. 
However, it’s worth noting that while this is a driver-related document, it doesn’t describe the driver API itself.

Thanks,
Shenwei

> --
> ~Randy