xref: /rk3399_ARM-atf/changelog.yaml (revision 48a59eb00a0a0489da170007ccff5e3c993bdf78)
1#
2# Copyright (c) 2021-2024, Arm Limited. All rights reserved.
3#
4# SPDX-License-Identifier: BSD-3-Clause
5#
6
7#
8# The following block describes the top-level sections of the changelog. Commits are categorized
9# into these top-level sections based on the commit message "type":
10#
11#     feat(xyz): add the xyz feature
12#     ^^^^
13#
14
15sections:
16  - title: New Features
17    description: A new feature
18    type: feat
19
20  - title: Resolved Issues
21    description: A bug fix
22    type: fix
23
24  - title: Build System
25    description: Changes that affect the build system or external dependencies
26    type: build
27    hidden: true
28
29  - title: Continuous Integration
30    description: Changes to our CI configuration files and scripts
31    type: ci
32    hidden: true
33
34  - title: Documentation
35    description: Documentation-only changes
36    type: docs
37    hidden: true
38
39  - title: Performance Improvements
40    description: A code change that improves performance
41    type: perf
42    hidden: true
43
44  - title: Code Refactoring
45    description: A code change that neither fixes a bug nor adds a feature
46    type: refactor
47    hidden: true
48
49  - title: Reverted Changes
50    description: Changes that revert a previous change
51    type: revert
52    hidden: true
53
54  - title: Style
55    description: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc.)
56    type: style
57    hidden: true
58
59  - title: Tests
60    description: Adding missing tests or correcting existing tests
61    type: test
62    hidden: true
63
64  - title: Miscellaneous
65    description: Any other change
66    type: chore
67    hidden: true
68
69#
70# The following block describes the sub-sections of the changelog. These sub-sections may appear in
71# any of the top-level sections, and describe the individual components that a change may relate to.
72#
73# Sub-sections have an optional associated commit message "scope":
74#
75#     feat(xyz): add the xyz feature
76#          ^^^
77#
78# This file also describes deprecated scopes, which are scopes that were used before we introduced
79# scope enforcement. These will not pass CI checks when used, but they will be used to generate the
80# changelog.
81#
82# Please note that new scopes should be kebab-case: https://en.wiktionary.org/wiki/kebab_case
83#
84
85subsections:
86  - title: Architecture
87
88    subsections:
89      - title: Activity Monitors Extension (FEAT_AMU)
90        scope: amu
91
92      - title: Branch Record Buffer Extension (FEAT_BRBE)
93        scope: brbe
94
95      - title: Branch Target Identification Extension
96        scope: bti
97
98      - title: Confidential Compute Architecture (CCA)
99        scope: cca
100
101      - title: Extended Cache Index (FEAT_CCIDX)
102        scope: ccidx
103
104      - title: Extended Translation Control Register (FEAT_TCR2).
105        scope: tcr2
106
107      - title: Fine-grained Traps 2 (FEAT_FGT2).
108        scope: fgt2
109
110      - title: CPU feature / ID register handling in general
111        scope: cpufeat
112
113      - title: Debug Extension (FEAT_Debugv8p9)
114        scope: debugv8p9
115
116      - title: Guarded Control Stack (FEAT_GCS)
117        scope: gcs
118
119      - title: Support for the `HCRX_EL2` register (FEAT_HCX)
120        scope: hcx
121
122      - title: Memory Partitioning and Monitoring (MPAM) Extension (FEAT_MPAM)
123        scope: mpam
124
125      - title: Memory Tagging Extension2
126        scope: mte2
127
128        deprecated:
129          - mte
130
131      - title: Pointer Authentication Extension
132        scope: pauth
133
134      - title: Performance Monitors Extension (FEAT_PMUv3)
135        scope: pmu
136
137      - title: Trapping support for RNDR/RNDRRS (FEAT_RNG_TRAP)
138        scope: rng-trap
139
140      - title: Scalable Matrix Extension (FEAT_SME, FEAT_SME2)
141        scope: sme
142
143      - title: Statistical profiling Extension (FEAT_SPE)
144        scope: spe
145
146      - title: Scalable Vector Extension (FEAT_SVE)
147        scope: sve
148
149      - title: System Register Trace Extensions (FEAT_ETMv4, FEAT_ETE and FEAT_ETEv1.1)
150        scope: sys-reg-trace
151
152        deprecated:
153          - sys_reg_trace
154
155      - title: Trace Buffer Extension (FEAT_TRBE)
156        scope: trbe
157
158      - title: Self-hosted Trace Extensions (FEAT_TRF)
159        scope: trf
160
161      - title: DynamIQ Shared Unit (DSU)
162        scope: dsu
163
164  - title: Platforms
165    scope: platforms
166
167    deprecated:
168      - plat/common
169      - plat
170
171    subsections:
172      - title: Allwinner
173        scope: allwinner
174
175        deprecated:
176          - plat/allwinner
177
178      - title: Arm
179        scope: arm
180
181        deprecated:
182          - plat/arm
183
184        subsections:
185          - title: A5DS
186            scope: a5ds
187
188          - title: CSS
189            scope: css
190
191            deprecated:
192              - plat/arm/css
193              - plat/css
194
195          - title: FPGA
196            scope: fpga
197
198            deprecated:
199              - arm_fgpa
200              - plat/arm_fpga
201              - arm/fpga
202
203          - title: FVP
204            scope: fvp
205
206            deprecated:
207              - plat/fvp
208              - fvp/tsp_manifest
209
210          - title: FVP-R
211            scope: fvp-r
212
213            deprecated:
214              - fvp_r
215
216          - title: FVP Versatile Express
217            scope: fvp_ve
218
219          - title: Juno
220            scope: juno
221
222          - title: Morello
223            scope: morello
224
225          - title: N1SDP
226            scope: n1sdp
227
228          - title: Neoverse-RD
229            scope: neoverse-rd
230
231            subsections:
232              - title: SGI-575
233                scope: sgi575
234
235              - title: RD-E1-Edge
236                scope: rde1edge
237
238              - title: RD-N1-Edge
239                scope: rdn1edge
240
241              - title: RD-V1
242                scope: rdv1
243
244              - title: RD-V1-MC
245                scope: rdv1mc
246
247              - title: RD-N2
248                scope: rdn2
249
250              - title: RD-V3
251                scope: rdv3
252
253                deprecated:
254                  - board/rdn2
255                  - rdfremont
256
257            deprecated:
258              - neoverse
259
260          - title: TC
261            scope: tc
262
263            deprecated:
264              - plat/tc
265
266            subsections:
267              - title: TC0
268                scope: tc0
269
270                deprecated:
271                  - plat/tc0
272
273          - title: Corstone-1000
274            scope: corstone-1000
275
276            deprecated:
277              - corstone1000
278
279          - title: Automotive RD
280            scope: automotive_rd
281
282            subsections:
283              - title: RD-1 AE
284                scope: rd1ae
285
286      - title: Aspeed
287        scope: aspeed
288
289        subsections:
290          - title: AST2700
291            scope: ast2700
292
293      - title: Broadcom
294        scope: brcm
295
296      - title: Cadence
297        scope: cadence
298
299      - title: HiSilicon
300        scope: hisilicon
301
302        subsections:
303          - title: HiKey
304            scope: hikey
305
306          - title: HiKey960
307            scope: hikey960
308
309          - title: Poplar
310            scope: poplar
311
312      - title: Intel
313        scope: intel
314
315        subsections:
316          - title: SoC
317            scope: soc
318
319      - title: Marvell
320        scope: marvell
321
322        deprecated:
323          - plat/marvell
324
325        subsections:
326          - title: Armada
327            scope: armada
328
329            deprecated:
330              - plat/marvell/armada
331
332            subsections:
333              - title: A3K
334                scope: a3k
335
336                deprecated:
337                  - plat/marvell/a3k
338
339              - title: A8K
340                scope: a8k
341
342                deprecated:
343                  - plat/marvell/a8k
344
345      - title: MediaTek
346        scope: mediatek
347
348        deprecated:
349          - plat/mediatek/common
350          - plat/mediatek
351
352        subsections:
353          - title: MT8183
354            scope: mt8183
355
356            deprecated:
357              - plat/mediatek/mt8183
358
359          - title: MT8186
360            scope: mt8186
361
362            deprecated:
363              - plat/mediatek/mt8186
364              - mt8186-emi-mpu
365
366          - title: MT8188
367            scope: mt8188
368
369          - title: MT8192
370            scope: mt8192
371
372            deprecated:
373              - plat/mdeiatek/mt8192
374
375          - title: MT8195
376            scope: mt8195
377
378            deprecated:
379              - plat/mediatek/me8195
380              - plat/mediatek/mt8195
381              - plat/mdeiatek/mt8195
382
383      - title: NVIDIA
384        scope: nvidia
385
386        subsections:
387          - title: Tegra
388            scope: tegra
389
390            deprecated:
391              - plat/tegra
392
393            subsections:
394              - title: Tegra 132
395                scope: tegra132
396
397              - title: Tegra 194
398                scope: tegra194
399
400              - title: Tegra 210
401                scope: tegra210
402
403      - title: NXP
404        scope: nxp
405
406        deprecated:
407          - plat/nxp
408          - plat/nxp/common
409
410        subsections:
411          - title: i.MX
412            scope: imx
413
414            deprecated:
415              - plat/imx
416              - plat/imx/imx
417
418            subsections:
419              - title: i.MX 8M
420                scope: imx8m
421
422                deprecated:
423                  - plat/imx8m
424                  - plat/imx/imx8m
425
426                subsections:
427                  - title: i.MX 8M Nano
428                    scope: imx8mn
429
430                    deprecated:
431                      - plat/imx/imx8m/imx8mn
432
433                  - title: i.MX 8M Mini
434                    scope: imx8mm
435
436                    deprecated:
437                      - plat/imx/imx8m/imx8mm
438
439                  - title: i.MX 8M Plus
440                    scope: imx8mp
441
442                    deprecated:
443                      - plat/imx/imx8m/imx8mp
444
445                  - title: i.MX 8Q
446                    scope: imx8mq
447
448                    deprecated:
449                      - plat/imx/imx8m/imx8mq
450
451              - title: i.MX 8
452                scope: imx8
453
454              - title: i.MX 8ULP
455                scope: imx8ulp
456
457              - title: i.MX 9
458                scope: imx9
459
460                subsections:
461                  - title: i.MX93
462                    scope: imx93
463
464          - title: Layerscape
465            scope: layerscape
466
467            deprecated:
468              - docs/nxp/layerscape
469
470            subsections:
471              - title: LS1028A
472                scope: ls1028a
473
474                deprecated:
475                  - plat/nxp/ls1028a
476
477                subsections:
478                  - title: LS1028ARDB
479                    scope: ls1028ardb
480
481                    deprecated:
482                      - plat/nxp/ls1028ardb
483
484              - title: LS1043A
485                scope: ls1043a
486
487                deprecated:
488                  - plat/nxp/ls1043a
489
490                subsections:
491                  - title: LS1043ARDB
492                    scope: ls1043ardb
493
494                    deprecated:
495                      - plat/nxp/ls1043ardb
496
497              - title: LX2
498                scope: lx2
499
500                deprecated:
501                  - plat/nxp/lx2
502
503                subsections:
504                  - title: LX216
505                    scope: lx216
506
507                    deprecated:
508                      - plat/nxp/lx216x
509
510                    subsections:
511                      - title: LX2160
512                        scope: lx2160
513
514                        deprecated:
515                          - plat/soc-lx2160
516
517              - title: LS1046A
518                scope: ls1046a
519
520                subsections:
521                  - title: LS1046ARDB
522                    scope: ls1046ardb
523
524                  - title: LS1046AFRWY
525                    scope: ls1046afrwy
526
527                  - title: LS1046AQDS
528                    scope: ls1046aqds
529
530              - title: LS1088A
531                scope: ls1088a
532
533                subsections:
534                  - title: LS1088ARDB
535                    scope: ls1088ardb
536
537                  - title: LS1088AQDS
538                    scope: ls1088aqds
539
540          - title: S32G274A
541            scope: s32g274a
542
543            subsections:
544              - title: S32G274ARDB
545                scope: s32g274ardb
546
547      - title: QEMU
548        scope: qemu
549
550        deprecated:
551          - plat/qemu
552
553        subsections:
554          - title: SBSA
555            scope: qemu-sbsa
556
557            deprecated:
558              - qemu_sbsa
559
560      - title: QTI
561        scope: qti
562
563        deprecated:
564          - plat/qti
565
566        subsections:
567          - title: SC1780
568            scope: sc7180
569
570            deprecated:
571              - plat/qti/sc7180
572
573          - title: SC7280
574            scope: sc7280
575
576            deprecated:
577              - plat/qti/sc7280
578
579          - title: MSM8916
580            scope: msm8916
581
582      - title: Raspberry Pi
583        scope: rpi
584
585        subsections:
586          - title: Raspberry Pi 3
587            scope: rpi3
588
589          - title: Raspberry Pi 4
590            scope: rpi4
591
592          - title: Raspberry Pi 5
593            scope: rpi5
594
595      - title: Renesas
596        scope: renesas
597
598        subsections:
599          - title: R-Car
600            scope: rcar
601
602            deprecated:
603              - plat/rcar
604
605            subsections:
606              - title: R-Car 3
607                scope: rcar3
608
609                deprecated:
610                  - plat/rcar3
611
612      - title: Rockchip
613        scope: rockchip
614
615        subsections:
616          - title: RK3399
617            scope: rk3399
618
619            deprecated:
620              - rockchip/rk3399
621              - rk3399/suspend
622
623          - title: RK3328
624            scope: rk3328
625
626          - title: RK3588
627            scope: rk3588
628
629      - title: Socionext
630        scope: socionext
631
632        subsections:
633          - title: Synquacer
634            scope: synquacer
635
636            deprecated:
637              - plat/synquacer
638
639      - title: ST
640        scope: st
641
642        deprecated:
643          - plat/st
644
645        subsections:
646          - title: STM32MP1
647            scope: stm32mp1
648
649            deprecated:
650              - plat/st/stm32mp1
651
652            subsections:
653              - title: STM32MP13
654                scope: stm32mp13
655
656              - title: STM32MP15
657                scope: stm32mp15
658
659          - title: STM32MP2
660            scope: stm32mp2
661
662            subsections:
663              - title: STM32MP25
664                scope: stm32mp25
665
666      - title: Texas Instruments
667        scope: ti
668
669        subsections:
670          - title: K3
671            scope: k3
672
673            deprecated:
674              - ti-k3
675
676      - title: Xilinx
677        scope: xilinx
678
679        deprecated:
680          - plat/xilinx
681
682        subsections:
683          - title: DCC (Debug Communication Channel)
684            scope: dcc
685
686          - title: Versal
687            scope: versal
688
689            deprecated:
690              - plat/xilinx/versal/include
691              - plat/xilinx/versal
692              - plat/versal
693
694          - title: Versal NET
695            scope: versal-net
696
697            deprecated:
698              - versal_net
699
700          - title: ZynqMP
701            scope: zynqmp
702
703            deprecated:
704              - plat/zynqmp
705              - plat/xilinx/zynqmp
706
707      - title: AMD
708        scope: amd
709
710        subsections:
711          - title: Versal Gen 2
712            scope: versal2
713
714      - title: Nuvoton
715        scope: nuvoton
716
717        subsections:
718          - title: npcm845x
719            scope: npcm845x
720
721  - title: Bootloader Images
722    scope: bl
723
724    deprecated:
725      - bl_common
726
727    subsections:
728      - title: BL1
729        scope: bl1
730
731      - title: BL2
732        scope: bl2
733
734      - title: BL31
735        scope: bl31
736
737      - title: BL32
738        scope: bl32
739
740        subsections:
741          - title: TSP
742            scope: tsp
743
744  - title: Services
745    scope: services
746
747    deprecated:
748      - std_svc
749
750    subsections:
751      - title: FF-A
752        scope: ff-a
753
754        deprecated:
755          - ffa
756
757      - title: RME
758        scope: rme
759
760        deprecated:
761          - rme/fid
762
763        subsections:
764          - title: TRP
765            scope: trp
766
767          - title: RMMD
768            scope: rmmd
769
770          - title: RMM
771            scope: rmm
772
773      - title: SPM
774        scope: spm
775
776        subsections:
777          - title: EL3 SPM
778            scope: el3-spm
779
780          - title: EL3 SPMC
781            scope: el3-spmc
782
783            deprecated:
784              - spmc
785
786          - title: SPMD
787            scope: spmd
788
789          - title: SPM MM
790            scope: spm-mm
791
792      - title: DRTM
793        scope: drtm
794
795      - title: TRNG
796        scope: trng
797
798      - title: ERRATA ABI
799        scope: errata-abi
800
801        deprecated:
802          - errata_abi
803
804      - title: ChromeOS
805        scope: cros
806
807  - title: Libraries
808    scope: lib
809
810    subsections:
811      - title: CPU Support
812        scope: cpus
813
814        deprecated:
815          - cpu
816          - errata
817          - errata_report
818
819      - title: EL3 Runtime
820        scope: el3-runtime
821
822        deprecated:
823          - el3_runtime
824
825        subsections:
826          - title: Context Management
827            scope: cm
828
829          - title: RAS
830            scope: ras
831
832          - title: SIMD
833            scope: simd
834
835      - title: FCONF
836        scope: fconf
837
838      - title: MPMM
839        scope: mpmm
840
841      - title: OP-TEE
842        scope: optee
843
844        deprecated:
845          - lib/optee
846
847      - title: PSCI
848        scope: psci
849
850      - title: ROMlib
851        scope: romlib
852
853      - title: GPT
854        scope: gpt
855
856        deprecated:
857          - gpt_rme
858
859      - title: SMCCC
860        scope: smccc
861
862      - title: Translation Tables
863        scope: xlat
864
865      - title: C Standard Library
866        scope: libc
867
868      - title: Locks
869        scope: locks
870
871      - title: PSA
872        scope: psa
873
874        deprecated:
875          - lib/psa
876
877      - title: DICE Protection Environment
878        scope: dice
879
880      - title: Context Management
881        scope: context-mgmt
882
883        deprecated:
884          - context mgmt
885
886      - title: Semihosting
887        scope: semihosting
888
889      - title: Firmware Handoff
890        scope: handoff
891
892      - title: Exception Handling Framework (EHF)
893        scope: ehf
894
895  - title: Drivers
896
897    subsections:
898      - title: Authentication
899        scope: auth
900
901        deprecated:
902          - driver/auth
903
904        subsections:
905          - title: CryptoCell-713
906            scope: cc-713
907
908          - title: Crypto
909            scope: crypto
910
911          - title: mbedTLS
912            scope: mbedtls
913
914          - title: mbedTLS-PSA
915            scope: mbedtls-psa
916
917      - title: Console
918        scope: console
919
920      - title: Delay Timer
921        scope: delay-timer
922
923      - title: Generic Clock
924        scope: clk
925
926      - title: FWU
927        scope: fwu
928
929        deprecated:
930          - fwu_metadata
931
932      - title: I/O
933        scope: io
934
935        subsections:
936          - title: MTD
937            scope: mtd
938
939            deprecated:
940              - io_mtd
941
942      - title: Measured Boot
943        scope: measured-boot
944
945        deprecated:
946          - measured boot
947          - measured_boot
948
949      - title: MMC
950        scope: mmc
951
952        deprecated:
953          - drivers/mmc
954
955      - title: MTD
956        scope: mtd
957
958        deprecated:
959          - drivers/mtd
960
961        subsections:
962          - title: NAND
963            scope: nand
964
965            subsections:
966              - title: SPI NAND
967                scope: spi-nand
968
969                deprecated:
970                  - spi_nand
971
972      - title: GUID Partition Tables Support
973        scope: guid-partition
974
975        deprecated:
976          - partition
977
978      - title: SCMI
979        scope: scmi
980
981        deprecated:
982          - scmi_common
983          - drivers/scmi-msg
984          - scmi-msg
985
986      - title: UFS
987        scope: ufs
988
989      - title: Arm
990        scope: arm-drivers
991
992        subsections:
993          - title: Ethos-N
994            scope: ethos-n
995
996            deprecated:
997              - drivers/arm/ethosn
998
999          - title: GIC
1000            scope: gic
1001
1002            subsections:
1003              - title: GICv3
1004                scope: gicv3
1005
1006                deprecated:
1007                  - gicv3/multichip
1008
1009                subsections:
1010                  - title: GIC-600
1011                    scope: gic600
1012
1013                  - title: GIC-600AE
1014                    scope: gic600ae
1015
1016              - title: GICv2
1017                scope: gicv2
1018
1019          - title: SMMU
1020            scope: smmu
1021
1022          - title: MHU
1023            scope: mhu
1024
1025            deprecated:
1026              - drivers/arm/mhu
1027
1028          - title: RSE
1029            scope: rse
1030
1031            deprecated:
1032              - drivers/arm/rss
1033              - rss
1034
1035          - title: TZC
1036            scope: tzc
1037
1038            subsections:
1039              - title: TZC-400
1040                scope: tzc400
1041
1042                deprecated:
1043                  - drivers/tzc400
1044
1045              - title: TZC-380
1046                scope: tzc380
1047
1048                deprecated:
1049                  - drivers/tzc380
1050
1051          - title: SBSA
1052            scope: sbsa
1053
1054      - title: Marvell
1055        scope: marvell-drivers
1056
1057        subsections:
1058          - title: COMPHY
1059            scope: marvell-comphy
1060
1061            deprecated:
1062              - drivers/marvell/comphy
1063
1064            subsections:
1065              - title: Armada 3700
1066                scope: marvell-comphy-3700
1067
1068                deprecated:
1069                  - drivers/marvell/comphy-3700
1070
1071              - title: CP110
1072                scope: marvell-comphy-cp110
1073
1074                deprecated:
1075                  - drivers/marvell/comphy-cp110
1076
1077          - title: UART
1078            scope: marvell-uart
1079
1080            deprecated:
1081              - plat/marvell/uart
1082
1083          - title: Armada
1084            scope: armada-drivers
1085
1086            subsections:
1087              - title: A3K
1088                scope: a3k-drivers
1089
1090                subsections:
1091                  - title: A3720
1092                    scope: a3720-uart
1093
1094                    deprecated:
1095                      - plat/marvell/a3720/uart
1096
1097      - title: MediaTek
1098        scope: mediatek-drivers
1099
1100        subsections:
1101          - title: APU
1102            scope: mediatek-apu
1103
1104            deprecated:
1105              - plat/mediatek/apu
1106
1107          - title: EMI MPU
1108            scope: mediatek-emi-mpu
1109
1110            deprecated:
1111              - plat/mediatek/mpu
1112
1113          - title: PMIC Wrapper
1114            scope: mediatek-pmic-wrapper
1115
1116            deprecated:
1117              - plat/mediatek/pmic_wrap
1118
1119          - title: MT8192
1120            scope: mt8192-drivers
1121
1122            subsections:
1123              - title: SPM
1124                scope: mt8192-spm
1125
1126                deprecated:
1127                  - mediatek/mt8192/spm
1128
1129      - title: NXP
1130        scope: nxp-drivers
1131
1132        subsections:
1133          - title: DCFG
1134            scope: nxp-dcfg
1135
1136            deprecated:
1137              - driver/nxp/dcfg
1138
1139          - title: FLEXSPI
1140            scope: flexspi
1141
1142            deprecated:
1143              - include/drivers/flexspi
1144              - driver/nxp/xspi
1145
1146          - title: SCFG
1147            scope: nxp-scfg
1148
1149            deprecated:
1150              - nxp/scfg
1151
1152          - title: SFP
1153            scope: nxp-sfp
1154
1155            deprecated:
1156              - drivers/nxp/sfp
1157
1158          - title: QSPI
1159            scope: nxp-qspi
1160
1161          - title: NXP Crypto
1162            scope: nxp-crypto
1163
1164          - title: DDR
1165            scope: nxp-ddr
1166
1167          - title: GIC
1168            scope: nxp-gic
1169
1170          - title: CSU
1171            scope: nxp-csu
1172
1173          - title: IFC NAND
1174            scope: nxp-ifc-nand
1175
1176          - title: IFC NOR
1177            scope: nxp-ifc-nor
1178
1179          - title: TZC-380
1180            scope: nxp-tzc380
1181
1182          - title: TRDC
1183            scope: imx-trdc
1184
1185          - title: Clock
1186            scope: nxp-clk
1187
1188      - title: Renesas
1189        scope: renesas-drivers
1190
1191        subsections:
1192          - title: R-Car3
1193            scope: rcar3-drivers
1194
1195            deprecated:
1196              - drivers/rcar3
1197
1198      - title: ST
1199        scope: st-drivers
1200
1201        deprecated:
1202          - drivers/st
1203
1204        subsections:
1205          - title: BSEC
1206            scope: st-bsec
1207
1208          - title: Clock
1209            scope: st-clock
1210
1211            deprecated:
1212              - stm32mp_clk
1213              - drivers/st/clk
1214              - stm32mp1_clk
1215
1216          - title: Crypto
1217            scope: st-crypto
1218
1219          - title: DDR
1220            scope: st-ddr
1221
1222          - title: I/O
1223            scope: st-io-drivers
1224
1225            subsections:
1226              - title: STM32 Image
1227                scope: st-io-stm32image
1228
1229                deprecated:
1230                  - io-stm32image
1231                  - io_stm32image
1232
1233          - title: I2C
1234            scope: st-i2c
1235
1236          - title: FMC
1237            scope: st-fmc
1238
1239          - title: GPIO
1240            scope: st-gpio
1241
1242          - title: SDMMC2
1243            scope: st-sdmmc2
1244
1245            deprecated:
1246              - stm32_sdmmc2
1247
1248          - title: ST PMIC
1249            scope: st-pmic
1250
1251            deprecated:
1252              - drivers/st/pmic
1253
1254          - title: STPMIC1
1255            scope: stpmic1
1256
1257          - title: Regulator
1258            scope: st-regulator
1259
1260          - title: Reset
1261            scope: st-reset
1262
1263          - title: SPI
1264            scope: st-spi
1265
1266          - title: UART
1267            scope: st-uart
1268
1269            subsections:
1270              - title: STM32 Console
1271                scope: stm32-console
1272
1273                deprecated:
1274                  - stm32_console
1275
1276          - title: USB
1277            scope: st-usb
1278
1279            deprecated:
1280              - drivers/st/usb
1281
1282          - title: Watchdog
1283            scope: st-iwdg
1284
1285      - title: USB
1286        scope: usb
1287
1288        deprecated:
1289          - drivers/usb
1290
1291  - title: Miscellaneous
1292
1293    subsections:
1294      - title: AArch64
1295        scope: aarch64
1296
1297      - title: Debug
1298        scope: debug
1299
1300        deprecated:
1301          - common/debug
1302
1303      - title: CRC32
1304        scope: crc32
1305
1306        subsections:
1307          - title: Hardware CRC32
1308            scope: hw-crc32
1309
1310            deprecated:
1311              - hw_crc
1312              - hw_crc32
1313
1314          - title: Software CRC32
1315            scope: sw-crc32
1316
1317            deprecated:
1318              - sw_crc32
1319
1320      - title: DT Bindings
1321        scope: dt-bindings
1322
1323      - title: FDT Wrappers
1324        scope: fdt-wrappers
1325
1326      - title: FDTs
1327        scope: fdts
1328
1329        deprecated:
1330          - fdt
1331
1332        subsections:
1333          - title: Morello
1334            scope: morello-fdts
1335
1336            deprecated:
1337              - fdts/morello
1338
1339          - title: STM32MP1
1340            scope: stm32mp1-fdts
1341
1342            deprecated:
1343              - fdts stm32mp1
1344
1345            subsections:
1346              - title: STM32MP13
1347                scope: stm32mp13-fdts
1348
1349              - title: STM32MP15
1350                scope: stm32mp15-fdts
1351
1352          - title: STM32MP2
1353            scope: stm32mp2-fdts
1354
1355            subsections:
1356              - title: STM32MP25
1357                scope: stm32mp25-fdts
1358
1359      - title: PIE
1360        scope: pie
1361
1362      - title: PIE/POR
1363        scope: pie/por
1364
1365      - title: Security
1366        scope: security
1367
1368      - title: SDEI
1369        scope: sdei
1370
1371      - title: TBBR
1372        scope: tbbr
1373
1374      - title: NXP
1375
1376        subsections:
1377          - title: OCRAM
1378            scope: nxp-ocram
1379
1380            deprecated:
1381              - nxp/common/ocram
1382
1383          - title: PSCI
1384            scope: nxp-psci
1385
1386            deprecated:
1387              - plat/nxp/common/psci
1388
1389      - title: UUID
1390        scope: uuid
1391
1392  - title: Documentation
1393    scope: docs
1394
1395    deprecated:
1396      - doc
1397
1398    subsections:
1399      - title: Changelog
1400        scope: changelog
1401
1402      - title: Commit Style
1403        scope: commit-style
1404
1405      - title: Contribution Guidelines
1406        scope: contributing
1407
1408        deprecated:
1409          - contribution-guidelines
1410          - docs-contributing.rst
1411
1412      - title: Maintainers
1413        scope: maintainers
1414
1415      - title: Prerequisites
1416        scope: prerequisites
1417
1418      - title: Threat Model
1419        scope: threat-model
1420
1421      - title: Porting Guide
1422        scope: porting
1423
1424  - title: Build System
1425    scope: build
1426
1427    deprecated:
1428      - makefile
1429      - Makefile
1430
1431    subsections:
1432      - title: Git Hooks
1433        scope: hooks
1434
1435        deprecated:
1436          - git-hooks
1437
1438  - title: Tools
1439    scope: tools
1440
1441    subsections:
1442      - title: STM32 Image
1443        scope: stm32image
1444
1445        deprecated:
1446          - tools/stm32image
1447
1448      - title: NXP Tools
1449        scope: nxp-tools
1450
1451      - title: Firmware Image Package Tool
1452        scope: fiptool
1453
1454      - title: Secure Partition Tool
1455        scope: sptool
1456
1457      - title: Certificate Creation Tool
1458        scope: cert-create
1459
1460      - title: Firmware Encryption Tool
1461        scope: encrypt-fw
1462
1463      - title: Memory Mapping Tool
1464        scope: memmap
1465
1466        deprecated:
1467          - cert_create
1468
1469      - title: Marvell Tools
1470        scope: marvell-tools
1471
1472      - title: Renesas Tools
1473        scope: renesas-tools
1474
1475        subsections:
1476          - title: R-Car Layout Tool
1477            scope: rcar-layout
1478
1479          - title: R/ZG Layout Tool
1480            scope: rzg-layout
1481
1482      - title: Transfer List Compiler
1483        scope: tlc
1484
1485      - title: Chain of Trust device tree to C source file
1486        scope: cot-dt2c
1487
1488  - title: Dependencies
1489    scope: deps
1490
1491    subsections:
1492      - title: checkpatch
1493        scope: checkpatch
1494
1495      - title: commitlint
1496        scope: commitlint
1497
1498      - title: Compiler runtime libraries
1499        scope: compiler-rt
1500
1501      - title: libfdt
1502        scope: libfdt
1503
1504      - title: Node Package Manager (NPM)
1505        scope: npm
1506
1507      - title: Poetry
1508        scope: poetry
1509
1510      - title: zlib
1511        scope: zlib
1512