Re: [PATCH] Documentation: Add category of subsystem-apis

[Randy Dunlap]

On 11/5/26 10:15 AM, Manuel Ebner wrote:
> Add Bus and Communication category to reduce number of items in
> 'Other subsystems'.
> 
> Signed-off-by: Manuel Ebner <manuelebnerli@xxxxxxxxxxx>

This LGTM but at first I was wondering why I2C is listed here but I3C
is not.  I3C is listed under driver-api/index.html. So are some other
buses.

That is a little confusing to me. ISTM that we need so *not* have
2 places listing bus documentation...

Anyway, this is a good start on that. It could be merged as is.

Reviewed-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
Tested-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>


> ---
>  Documentation/subsystem-apis.rst | 21 ++++++++++++++-------
>  1 file changed, 14 insertions(+), 7 deletions(-)
> 
> diff --git a/Documentation/subsystem-apis.rst b/Documentation/subsystem-apis.rst
> index b1ad48bb40..4e886897d3 100644
> --- a/Documentation/subsystem-apis.rst
> +++ b/Documentation/subsystem-apis.rst
> @@ -24,6 +24,20 @@ Core subsystems
>     timers/index
>     locking/index
>  
> +Bus and Communication interfaces
> +--------------------------------
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   i2c/index
> +   pcmcia/index
> +   spi/index
> +   w1/index
> +   usb/index
> +   PCI/index
> +   peci/index
> +
>  Human interfaces
>  ----------------
>  
> @@ -72,11 +86,7 @@ Other subsystems
>     cpu-freq/index
>     edac/index
>     fpga/index
> -   i2c/index
>     iio/index
> -   pcmcia/index
> -   spi/index
> -   w1/index
>     watchdog/index
>     virt/index
>     hwmon/index
> @@ -84,9 +94,6 @@ Other subsystems
>     security/index
>     crypto/index
>     bpf/index
> -   usb/index
> -   PCI/index
>     misc-devices/index
> -   peci/index
>     wmi/index
>     tee/index

-- 
~Randy