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