Re: [PATCH 00/33] doc: board: amlogic: spring clean-up of Amlogic docs

2023-03-22 Thread Neil Armstrong
Hi,

On Mon, 20 Mar 2023 11:45:36 +, Christian Hewitt wrote:
> Amlogic documentation spans U-Boot support from 2015-current resulting
> in older content being harder to follow. And due to many international
> contributors the docs also contain grammar quirks.
> 
> This series reworks all board documents to be more consistent. There is
> deliberate emphasis on using the amlogic-boot-fip repo for signing tasks
> as this is easier for most users to follow. The original/longer signing
> process (described as Manual Signing) has been tidied up.
> 
> [...]

Thanks, Applied to https://source.denx.de/u-boot/custodians/u-boot-amlogic 
(u-boot-amlogic-test)

[01/33] doc: boards: amlogic: update documentation for index page

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/862b7c1fcc5e94c7d91cc9caf22c7b6205b7fffd
[02/33] doc: boards: amlogic: update documentation for boot-flow

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/4ce746b8cf07ed4c532a36fda587104d667bf54a
[03/33] doc: boards: amlogic: update documentation for pre-generated-fip's

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/3d1744b392ae57adfa1c068acb9f94a44cc82070
[04/33] doc: boards: amlogic: update documentation for Beelink GT-King

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/d0d4a85d14b18dda87ef0111a03644a9886aebd4
[05/33] doc: boards: amlogic: update documentation for Beelink GT-King Pro

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/c03d19d5dc0e20dde9c4b34feb0f47c59a82a640
[06/33] doc: boards: amlogic: update documentation for JetHub J100

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/cf43c9f7d3c7b4b83a94a9ff961b0807f4f92c47
[07/33] doc: boards: amlogic: update documentation for JetHub J80

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/47ab069e9a9dd047dcad3c984d8e6cbcb6e26a04
[08/33] doc: boards: amlogic: update documentation for Khadas VIM

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/329794577adf7e53ba1e0c3a86686e21655965c1
[09/33] doc: boards: amlogic: update documentation for Khadas VIM2

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/e3de21c60685d15fd5746b23a7d72545889580cd
[10/33] doc: boards: amlogic: update documentation for Khadas VIM3

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/de54d4cc16b9d4bfdda196dac5bdbd0d8128cd02
[11/33] doc: boards: amlogic: update documentation for Khadas VIM3L

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/3240318b212d46e1e5ea4af92eec6b26b67f5ad4
[12/33] doc: boards: amlogic: update documentation for LaFrite

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/cb197ca63debc82d23a8ca419623278839b6ff48
[13/33] doc: boards: amlogic: update documentation for LePotato

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/ba07d965dd5ee74e66c32bc5a3fce5c69ed4b2d2
[14/33] doc: boards: amlogic: update documentation for NanoPi-K2

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/7c7ecc84f1c1edb79e7e2b1e0070b288cf1e22fc
[15/33] doc: boards: amlogic: update documentation for ODROID-C2

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/665633ec055d15989e187861ea419518bf517017
[16/33] doc: boards: amlogic: update documentation for ODROID-C4

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/4760b2e8e2e46ad61ab7ed91733786d9a9e4696c
[17/33] doc: boards: amlogic: update documentation for ODROID GO ULTRA

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/144ffe96aa1638028593afa2b669bcf08ac0ad38
[18/33] doc: boards: amlogic: update documentation for ODROID-N2/N2+

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/11a1fc1d305e773f27135adad56cbcc5e1c2bd6a
[19/33] doc: boards: amlogic: update documentation for ODROID-N2L

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/6ba5d42c42752829b22f80748972716d5bb27c59
[20/33] doc: boards: amlogic: update documentation for P200

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/f0b8c1f6a54b8ef45972a18e969250d859c9a866
[21/33] doc: boards: amlogic: update documentation for P201

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/db6b333e37c2a98e2bcc09a5545635aaeb2c1301
[22/33] doc: boards: amlogic: update documentation for Q200

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/3ce3109c3783c27aa18b0a17eb6d8ead23f92d85
[23/33] doc: boards: amlogic: update documentation for Radxa Zero

https://source.denx.de/u-boot/custodians/u-boot-amlogic/-/commit/1b23862b4177151b477d740e8760d45978549926
[24/33] doc: boards: amlogic: update documentation for S400


[PATCH 00/33] doc: board: amlogic: spring clean-up of Amlogic docs

2023-03-20 Thread Christian Hewitt
Amlogic documentation spans U-Boot support from 2015-current resulting
in older content being harder to follow. And due to many international
contributors the docs also contain grammar quirks.

This series reworks all board documents to be more consistent. There is
deliberate emphasis on using the amlogic-boot-fip repo for signing tasks
as this is easier for most users to follow. The original/longer signing
process (described as Manual Signing) has been tidied up.

In the index.rst file I've dropped board names from the features table
as this adds considerable width and makes adding new boards a fiddly
process. I've appended the SoC type to the boader header so it shows in
the TOC list to retain a reference between boards and the table.

I've added missing board docs for GS-King-X, BPI-M5, BPI-CM4IO, and we
split ODROID-HC4 into its own document. It originally followed the same
process as the ODROID0-C4, but now has a separate defconfig to enable
SPI-NOR and PCIe SATA support. Users occasionally follow the current
doc and build U-Boot for the C4 which omits this and then struggle to
figure out why SATA boot doesn't work when wiki/forums say it does.

There are other minor cleanups and tweaks for clarity of simply more
up-to-date information for a board or process.

Please review and flag any omissions or issues!

Christian Hewitt (33):
  doc: boards: amlogic: update documentation for index page
  doc: boards: amlogic: update documentation for boot-flow
  doc: boards: amlogic: update documentation for pre-generated-fip's
  doc: boards: amlogic: update documentation for Beelink GT-King
  doc: boards: amlogic: update documentation for Beelink GT-King Pro
  doc: boards: amlogic: update documentation for JetHub J100
  doc: boards: amlogic: update documentation for JetHub J80
  doc: boards: amlogic: update documentation for Khadas VIM
  doc: boards: amlogic: update documentation for Khadas VIM2
  doc: boards: amlogic: update documentation for Khadas VIM3
  doc: boards: amlogic: update documentation for Khadas VIM3L
  doc: boards: amlogic: update documentation for LaFrite
  doc: boards: amlogic: update documentation for LePotato
  doc: boards: amlogic: update documentation for NanoPi-K2
  doc: boards: amlogic: update documentation for ODROID-C2
  doc: boards: amlogic: update documentation for ODROID-C4
  doc: boards: amlogic: update documentation for ODROID GO ULTRA
  doc: boards: amlogic: update documentation for ODROID-N2/N2+
  doc: boards: amlogic: update documentation for ODROID-N2L
  doc: boards: amlogic: update documentation for P200
  doc: boards: amlogic: update documentation for P201
  doc: boards: amlogic: update documentation for Q200
  doc: boards: amlogic: update documentation for Radxa Zero
  doc: boards: amlogic: update documentation for S400
  doc: boards: amlogic: update documentation for SEI510
  doc: boards: amlogic: update documentation for SEI610
  doc: boards: amlogic: update documentation for U200
  doc: boards: amlogic: update documentation for W400
  doc: boards: amlogic: update documentation for WeTek Core2
  doc: boards: amlogic: add documentation for BananaPi CM4IO
  doc: boards: amlogic: add documentation for BananaPi M5
  doc: boards: amlogic: add documentation for GS-King-X
  doc: boards: amlogic: add documentation for ODROID-HC4

 board/amlogic/beelink-s922x/MAINTAINERS |   3 +-
 board/amlogic/u200/MAINTAINERS  |   1 -
 board/amlogic/w400/MAINTAINERS  |   2 +
 doc/board/amlogic/bananapi-cm4io.rst| 152 
 doc/board/amlogic/bananapi-m5.rst   | 141 +++
 doc/board/amlogic/beelink-gskingx.rst   | 121 
 doc/board/amlogic/beelink-gtking.rst| 120 
 doc/board/amlogic/beelink-gtkingpro.rst | 120 
 doc/board/amlogic/boot-flow.rst | 178 
 doc/board/amlogic/index.rst | 141 +--
 doc/board/amlogic/jethub-j100.rst   |  66 -
 doc/board/amlogic/jethub-j80.rst|  46 +++---
 doc/board/amlogic/khadas-vim.rst|  76 +-
 doc/board/amlogic/khadas-vim2.rst   |  76 +-
 doc/board/amlogic/khadas-vim3.rst   | 137 +-
 doc/board/amlogic/khadas-vim3l.rst  | 137 +-
 doc/board/amlogic/libretech-ac.rst  |  77 +-
 doc/board/amlogic/libretech-cc.rst  | 109 ++-
 doc/board/amlogic/nanopi-k2.rst |  93 +++--
 doc/board/amlogic/odroid-c2.rst |  54 +++
 doc/board/amlogic/odroid-c4.rst | 117 
 doc/board/amlogic/odroid-go-ultra.rst   |  25 +++-
 doc/board/amlogic/odroid-hc4.rst| 141 +++
 doc/board/amlogic/odroid-n2.rst | 122 
 doc/board/amlogic/odroid-n2l.rst|  33 +++--
 doc/board/amlogic/p200.rst  |  87 +++-
 doc/board/amlogic/p201.rst  |  87 +++-
 doc/board/amlogic/pre-generated-fip.rst | 138