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