Re: [RFC PATCH] docs/devel: try and impose some organisation

[Kashyap Chamarthy]

On Wed, Mar 09, 2022 at 01:53:55PM +0000, Alex Bennée wrote:
> We have a growing set of developer docs but the index is currently in
> order of when stuff was added. Try and make things a bit easier to
> find my adding sub indexes and organising into themes.
> 
> Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
> ---
>  docs/devel/index-api.rst       | 15 +++++++++++
>  docs/devel/index-build.rst     | 20 +++++++++++++++
>  docs/devel/index-internals.rst | 22 ++++++++++++++++
>  docs/devel/index-process.rst   | 18 +++++++++++++
>  docs/devel/index-tcg.rst       | 17 +++++++++++++
>  docs/devel/index.rst           | 46 ++++++----------------------------
>  6 files changed, 99 insertions(+), 39 deletions(-)
>  create mode 100644 docs/devel/index-api.rst
>  create mode 100644 docs/devel/index-build.rst
>  create mode 100644 docs/devel/index-internals.rst
>  create mode 100644 docs/devel/index-process.rst
>  create mode 100644 docs/devel/index-tcg.rst

Yeah, the sub-indexes idea looks good to me.  It's good to start this
before it gets out of hand :-)

As discussed on IRC, there seems to be some whitespace damage:

    $> git describe
    v6.2.0-2381-g034e818c93
    
    $>  ~/Mail/patch-temp/cur/1647009097.180136_1.paraplu\:2\,S
    Applying: docs/devel: try and impose some organisation
    .git/rebase-apply/patch:61: trailing whitespace.
          
    .git/rebase-apply/patch:89: trailing whitespace.
          
    .git/rebase-apply/patch:113: trailing whitespace.
          
    .git/rebase-apply/patch:136: trailing whitespace.
          
    .git/rebase-apply/patch:61: new blank line at EOF.
    +
    warning: squelched 3 whitespace errors
    warning: 8 lines add whitespace errors.

FWIW:

Reviewed-by: Kashyap Chamarthy <kchamart@redhat.com>    

[...]

-- 
/kashyap