diff mbox series

[1/2] doc: ti: reorganize existing ti docs

Message ID 20221219202950.1581-2-bb@ti.com
State Accepted, archived
Commit 0820e117c3a20afbf0ec611475e3719e8d8c83b1
Delegated to: Heinrich Schuchardt
Headers show
Series TI's K3 documentation updates | expand

Commit Message

Bryan Brattlof Dec. 19, 2022, 8:29 p.m. UTC
Texas Instruments produces quite a lot of SoCs based upon a common
architecture 'generation'. (eg: OMAP, K3) TI's existing documentation
layout makes noticing this generation jump rather difficult.

To make navigation easier, split the existing documentation into
individual SoC families so we may begin grouping them according to their
generational (eg: OMAP, K3) families.

Signed-off-by: Bryan Brattlof <bb@ti.com>
---
 doc/board/ti/am335x_evm.rst | 5 ++++-
 doc/board/ti/am62x_sk.rst   | 4 ++--
 doc/board/ti/j721e_evm.rst  | 4 ++--
 3 files changed, 8 insertions(+), 5 deletions(-)

Comments

Heinrich Schuchardt Dec. 22, 2022, 9:56 a.m. UTC | #1
On 12/19/22 21:29, Bryan Brattlof wrote:
> Texas Instruments produces quite a lot of SoCs based upon a common
> architecture 'generation'. (eg: OMAP, K3) TI's existing documentation
> layout makes noticing this generation jump rather difficult.
>
> To make navigation easier, split the existing documentation into
> individual SoC families so we may begin grouping them according to their
> generational (eg: OMAP, K3) families.
>
> Signed-off-by: Bryan Brattlof <bb@ti.com>
> ---
>   doc/board/ti/am335x_evm.rst | 5 ++++-
>   doc/board/ti/am62x_sk.rst   | 4 ++--
>   doc/board/ti/j721e_evm.rst  | 4 ++--
>   3 files changed, 8 insertions(+), 5 deletions(-)
>
> diff --git a/doc/board/ti/am335x_evm.rst b/doc/board/ti/am335x_evm.rst
> index a90f32da7aea5..7db9604ce05c9 100644
> --- a/doc/board/ti/am335x_evm.rst
> +++ b/doc/board/ti/am335x_evm.rst
> @@ -1,8 +1,11 @@
>   .. SPDX-License-Identifier: GPL-2.0+ OR BSD-3-Clause
>   .. sectionauthor:: Tom Rini <trini@konsulko.com>
>
> +AM335x Generation
> +=================
> +
>   Summary
> -=======

"AM335x Generation" is a level 1 header (<h1>). "Summary" should not be
on the same header level. Please, use:

Summary
-------

Best regards

Heinrich

> +-------
>
>   This document covers various features of the `am335x_evm` default
>   configuration, some of the related defconfigs, and how to enable hardware
> diff --git a/doc/board/ti/am62x_sk.rst b/doc/board/ti/am62x_sk.rst
> index 4e68c2018a50b..b1b7d99befb92 100644
> --- a/doc/board/ti/am62x_sk.rst
> +++ b/doc/board/ti/am62x_sk.rst
> @@ -1,8 +1,8 @@
>   .. SPDX-License-Identifier: GPL-2.0+ OR BSD-3-Clause
>   .. sectionauthor:: Vignesh Raghavendra <vigneshr@ti.com>
>
> -Texas Instruments AM62 Platforms
> -================================
> +AM62 Platforms
> +===============
>
>   Introduction:
>   -------------
> diff --git a/doc/board/ti/j721e_evm.rst b/doc/board/ti/j721e_evm.rst
> index ad70f15b7a418..e898601c41ea4 100644
> --- a/doc/board/ti/j721e_evm.rst
> +++ b/doc/board/ti/j721e_evm.rst
> @@ -1,8 +1,8 @@
>   .. SPDX-License-Identifier: GPL-2.0+ OR BSD-3-Clause
>   .. sectionauthor:: Lokesh Vutla <lokeshvutla@ti.com>
>
> -Texas Instruments K3 Platforms
> -==============================
> +J721E Platforms
> +===============
>
>   Introduction:
>   -------------
Heinrich Schuchardt Dec. 22, 2022, 9:58 a.m. UTC | #2
On 12/22/22 10:56, Heinrich Schuchardt wrote:
> On 12/19/22 21:29, Bryan Brattlof wrote:
>> Texas Instruments produces quite a lot of SoCs based upon a common
>> architecture 'generation'. (eg: OMAP, K3) TI's existing documentation
>> layout makes noticing this generation jump rather difficult.
>>
>> To make navigation easier, split the existing documentation into
>> individual SoC families so we may begin grouping them according to their
>> generational (eg: OMAP, K3) families.
>>
>> Signed-off-by: Bryan Brattlof <bb@ti.com>
>> ---
>>   doc/board/ti/am335x_evm.rst | 5 ++++-
>>   doc/board/ti/am62x_sk.rst   | 4 ++--
>>   doc/board/ti/j721e_evm.rst  | 4 ++--
>>   3 files changed, 8 insertions(+), 5 deletions(-)
>>
>> diff --git a/doc/board/ti/am335x_evm.rst b/doc/board/ti/am335x_evm.rst
>> index a90f32da7aea5..7db9604ce05c9 100644
>> --- a/doc/board/ti/am335x_evm.rst
>> +++ b/doc/board/ti/am335x_evm.rst
>> @@ -1,8 +1,11 @@
>>   .. SPDX-License-Identifier: GPL-2.0+ OR BSD-3-Clause
>>   .. sectionauthor:: Tom Rini <trini@konsulko.com>
>>
>> +AM335x Generation
>> +=================
>> +
>>   Summary
>> -=======
>
> "AM335x Generation" is a level 1 header (<h1>). "Summary" should not be
> on the same header level. Please, use:
>
> Summary
> -------

Sorry misread the patch.

Reviewed-by: Heinrich Schuchardt <xypron.glpk@gmx.de>

>
> Best regards
>
> Heinrich
>
>> +-------
>>
>>   This document covers various features of the `am335x_evm` default
>>   configuration, some of the related defconfigs, and how to enable
>> hardware
>> diff --git a/doc/board/ti/am62x_sk.rst b/doc/board/ti/am62x_sk.rst
>> index 4e68c2018a50b..b1b7d99befb92 100644
>> --- a/doc/board/ti/am62x_sk.rst
>> +++ b/doc/board/ti/am62x_sk.rst
>> @@ -1,8 +1,8 @@
>>   .. SPDX-License-Identifier: GPL-2.0+ OR BSD-3-Clause
>>   .. sectionauthor:: Vignesh Raghavendra <vigneshr@ti.com>
>>
>> -Texas Instruments AM62 Platforms
>> -================================
>> +AM62 Platforms
>> +===============
>>
>>   Introduction:
>>   -------------
>> diff --git a/doc/board/ti/j721e_evm.rst b/doc/board/ti/j721e_evm.rst
>> index ad70f15b7a418..e898601c41ea4 100644
>> --- a/doc/board/ti/j721e_evm.rst
>> +++ b/doc/board/ti/j721e_evm.rst
>> @@ -1,8 +1,8 @@
>>   .. SPDX-License-Identifier: GPL-2.0+ OR BSD-3-Clause
>>   .. sectionauthor:: Lokesh Vutla <lokeshvutla@ti.com>
>>
>> -Texas Instruments K3 Platforms
>> -==============================
>> +J721E Platforms
>> +===============
>>
>>   Introduction:
>>   -------------
>
diff mbox series

Patch

diff --git a/doc/board/ti/am335x_evm.rst b/doc/board/ti/am335x_evm.rst
index a90f32da7aea5..7db9604ce05c9 100644
--- a/doc/board/ti/am335x_evm.rst
+++ b/doc/board/ti/am335x_evm.rst
@@ -1,8 +1,11 @@ 
 .. SPDX-License-Identifier: GPL-2.0+ OR BSD-3-Clause
 .. sectionauthor:: Tom Rini <trini@konsulko.com>
 
+AM335x Generation
+=================
+
 Summary
-=======
+-------
 
 This document covers various features of the `am335x_evm` default
 configuration, some of the related defconfigs, and how to enable hardware
diff --git a/doc/board/ti/am62x_sk.rst b/doc/board/ti/am62x_sk.rst
index 4e68c2018a50b..b1b7d99befb92 100644
--- a/doc/board/ti/am62x_sk.rst
+++ b/doc/board/ti/am62x_sk.rst
@@ -1,8 +1,8 @@ 
 .. SPDX-License-Identifier: GPL-2.0+ OR BSD-3-Clause
 .. sectionauthor:: Vignesh Raghavendra <vigneshr@ti.com>
 
-Texas Instruments AM62 Platforms
-================================
+AM62 Platforms
+===============
 
 Introduction:
 -------------
diff --git a/doc/board/ti/j721e_evm.rst b/doc/board/ti/j721e_evm.rst
index ad70f15b7a418..e898601c41ea4 100644
--- a/doc/board/ti/j721e_evm.rst
+++ b/doc/board/ti/j721e_evm.rst
@@ -1,8 +1,8 @@ 
 .. SPDX-License-Identifier: GPL-2.0+ OR BSD-3-Clause
 .. sectionauthor:: Lokesh Vutla <lokeshvutla@ti.com>
 
-Texas Instruments K3 Platforms
-==============================
+J721E Platforms
+===============
 
 Introduction:
 -------------