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: CPU feature / ID register handling in general
108        scope: cpufeat
109
110      - title: Guarded Control Stack (FEAT_GCS)
111        scope: gcs
112
113      - title: Support for the `HCRX_EL2` register (FEAT_HCX)
114        scope: hcx
115
116      - title: Memory Partitioning and Monitoring (MPAM) Extension (FEAT_MPAM)
117        scope: mpam
118
119      - title: Memory Tagging Extension2
120        scope: mte2
121
122        deprecated:
123          - mte
124
125      - title: Pointer Authentication Extension
126        scope: pauth
127
128      - title: Performance Monitors Extension (FEAT_PMUv3)
129        scope: pmu
130
131      - title: Trapping support for RNDR/RNDRRS (FEAT_RNG_TRAP)
132        scope: rng-trap
133
134      - title: Scalable Matrix Extension (FEAT_SME, FEAT_SME2)
135        scope: sme
136
137      - title: Statistical profiling Extension (FEAT_SPE)
138        scope: spe
139
140      - title: Scalable Vector Extension (FEAT_SVE)
141        scope: sve
142
143      - title: System Register Trace Extensions (FEAT_ETMv4, FEAT_ETE and FEAT_ETEv1.1)
144        scope: sys-reg-trace
145
146        deprecated:
147          - sys_reg_trace
148
149      - title: Trace Buffer Extension (FEAT_TRBE)
150        scope: trbe
151
152      - title: Self-hosted Trace Extensions (FEAT_TRF)
153        scope: trf
154
155      - title: DynamIQ Shared Unit (DSU)
156        scope: dsu
157
158  - title: Platforms
159    scope: platforms
160
161    deprecated:
162      - plat/common
163      - plat
164
165    subsections:
166      - title: Allwinner
167        scope: allwinner
168
169        deprecated:
170          - plat/allwinner
171
172      - title: Arm
173        scope: arm
174
175        deprecated:
176          - plat/arm
177
178        subsections:
179          - title: A5DS
180            scope: a5ds
181
182          - title: CSS
183            scope: css
184
185            deprecated:
186              - plat/arm/css
187              - plat/css
188
189          - title: FPGA
190            scope: fpga
191
192            deprecated:
193              - arm_fgpa
194              - plat/arm_fpga
195              - arm/fpga
196
197          - title: FVP
198            scope: fvp
199
200            deprecated:
201              - plat/fvp
202              - fvp/tsp_manifest
203
204          - title: FVP-R
205            scope: fvp-r
206
207            deprecated:
208              - fvp_r
209
210          - title: FVP Versatile Express
211            scope: fvp_ve
212
213          - title: Juno
214            scope: juno
215
216          - title: Morello
217            scope: morello
218
219          - title: N1SDP
220            scope: n1sdp
221
222          - title: Neoverse-RD
223            scope: neoverse-rd
224
225            subsections:
226              - title: SGI-575
227                scope: sgi575
228
229              - title: RD-E1-Edge
230                scope: rde1edge
231
232              - title: RD-N1-Edge
233                scope: rdn1edge
234
235              - title: RD-V1
236                scope: rdv1
237
238              - title: RD-V1-MC
239                scope: rdv1mc
240
241              - title: RD-N2
242                scope: rdn2
243
244                deprecated:
245                  - board/rdn2
246
247            deprecated:
248              - neoverse
249
250          - title: TC
251            scope: tc
252
253            deprecated:
254              - plat/tc
255
256            subsections:
257              - title: TC0
258                scope: tc0
259
260                deprecated:
261                  - plat/tc0
262
263          - title: Corstone-1000
264            scope: corstone-1000
265
266      - title: Aspeed
267        scope: aspeed
268
269        subsections:
270          - title: AST2700
271            scope: ast2700
272
273      - title: Broadcom
274        scope: brcm
275
276      - title: Cadence
277        scope: cadence
278
279      - title: HiSilicon
280        scope: hisilicon
281
282        subsections:
283          - title: HiKey
284            scope: hikey
285
286          - title: HiKey960
287            scope: hikey960
288
289      - title: Intel
290        scope: intel
291
292        subsections:
293          - title: SoC
294            scope: soc
295
296      - title: Marvell
297        scope: marvell
298
299        deprecated:
300          - plat/marvell
301
302        subsections:
303          - title: Armada
304            scope: armada
305
306            deprecated:
307              - plat/marvell/armada
308
309            subsections:
310              - title: A3K
311                scope: a3k
312
313                deprecated:
314                  - plat/marvell/a3k
315
316              - title: A8K
317                scope: a8k
318
319                deprecated:
320                  - plat/marvell/a8k
321
322      - title: MediaTek
323        scope: mediatek
324
325        deprecated:
326          - plat/mediatek/common
327          - plat/mediatek
328
329        subsections:
330          - title: MT8183
331            scope: mt8183
332
333            deprecated:
334              - plat/mediatek/mt8183
335
336          - title: MT8186
337            scope: mt8186
338
339            deprecated:
340              - plat/mediatek/mt8186
341              - mt8186-emi-mpu
342
343          - title: MT8188
344            scope: mt8188
345
346          - title: MT8192
347            scope: mt8192
348
349            deprecated:
350              - plat/mdeiatek/mt8192
351
352          - title: MT8195
353            scope: mt8195
354
355            deprecated:
356              - plat/mediatek/me8195
357              - plat/mediatek/mt8195
358              - plat/mdeiatek/mt8195
359
360      - title: NVIDIA
361        scope: nvidia
362
363        subsections:
364          - title: Tegra
365            scope: tegra
366
367            deprecated:
368              - plat/tegra
369
370            subsections:
371              - title: Tegra 132
372                scope: tegra132
373
374              - title: Tegra 194
375                scope: tegra194
376
377              - title: Tegra 210
378                scope: tegra210
379
380      - title: NXP
381        scope: nxp
382
383        deprecated:
384          - plat/nxp
385          - plat/nxp/common
386
387        subsections:
388          - title: i.MX
389            scope: imx
390
391            deprecated:
392              - plat/imx
393              - plat/imx/imx
394
395            subsections:
396              - title: i.MX 8M
397                scope: imx8m
398
399                deprecated:
400                  - plat/imx8m
401                  - plat/imx/imx8m
402
403                subsections:
404                  - title: i.MX 8M Nano
405                    scope: imx8mn
406
407                    deprecated:
408                      - plat/imx/imx8m/imx8mn
409
410                  - title: i.MX 8M Mini
411                    scope: imx8mm
412
413                    deprecated:
414                      - plat/imx/imx8m/imx8mm
415
416                  - title: i.MX 8M Plus
417                    scope: imx8mp
418
419                    deprecated:
420                      - plat/imx/imx8m/imx8mp
421
422                  - title: i.MX 8Q
423                    scope: imx8mq
424
425                    deprecated:
426                      - plat/imx/imx8m/imx8mq
427
428              - title: i.MX 8
429                scope: imx8
430
431              - title: i.MX 8ULP
432                scope: imx8ulp
433
434              - title: i.MX 9
435                scope: imx9
436
437                subsections:
438                  - title: i.MX93
439                    scope: imx93
440
441          - title: Layerscape
442            scope: layerscape
443
444            deprecated:
445              - docs/nxp/layerscape
446
447            subsections:
448              - title: LS1028A
449                scope: ls1028a
450
451                deprecated:
452                  - plat/nxp/ls1028a
453
454                subsections:
455                  - title: LS1028ARDB
456                    scope: ls1028ardb
457
458                    deprecated:
459                      - plat/nxp/ls1028ardb
460
461              - title: LS1043A
462                scope: ls1043a
463
464                deprecated:
465                  - plat/nxp/ls1043a
466
467                subsections:
468                  - title: LS1043ARDB
469                    scope: ls1043ardb
470
471                    deprecated:
472                      - plat/nxp/ls1043ardb
473
474              - title: LX2
475                scope: lx2
476
477                deprecated:
478                  - plat/nxp/lx2
479
480                subsections:
481                  - title: LX216
482                    scope: lx216
483
484                    deprecated:
485                      - plat/nxp/lx216x
486
487                    subsections:
488                      - title: LX2160
489                        scope: lx2160
490
491                        deprecated:
492                          - plat/soc-lx2160
493
494              - title: LS1046A
495                scope: ls1046a
496
497                subsections:
498                  - title: LS1046ARDB
499                    scope: ls1046ardb
500
501                  - title: LS1046AFRWY
502                    scope: ls1046afrwy
503
504                  - title: LS1046AQDS
505                    scope: ls1046aqds
506
507              - title: LS1088A
508                scope: ls1088a
509
510                subsections:
511                  - title: LS1088ARDB
512                    scope: ls1088ardb
513
514                  - title: LS1088AQDS
515                    scope: ls1088aqds
516
517          - title: S32G274A
518            scope: s32g274a
519
520            subsections:
521              - title: S32G274ARDB
522                scope: s32g274ardb
523
524      - title: QEMU
525        scope: qemu
526
527        deprecated:
528          - plat/qemu
529
530        subsections:
531          - title: SBSA
532            scope: qemu-sbsa
533
534            deprecated:
535              - qemu_sbsa
536
537      - title: QTI
538        scope: qti
539
540        deprecated:
541          - plat/qti
542
543        subsections:
544          - title: SC1780
545            scope: sc7180
546
547            deprecated:
548              - plat/qti/sc7180
549
550          - title: SC7280
551            scope: sc7280
552
553            deprecated:
554              - plat/qti/sc7280
555
556          - title: MSM8916
557            scope: msm8916
558
559      - title: Raspberry Pi
560        scope: rpi
561
562        subsections:
563          - title: Raspberry Pi 3
564            scope: rpi3
565
566          - title: Raspberry Pi 4
567            scope: rpi4
568
569          - title: Raspberry Pi 5
570            scope: rpi5
571
572      - title: Renesas
573        scope: renesas
574
575        subsections:
576          - title: R-Car
577            scope: rcar
578
579            deprecated:
580              - plat/rcar
581
582            subsections:
583              - title: R-Car 3
584                scope: rcar3
585
586                deprecated:
587                  - plat/rcar3
588
589      - title: Rockchip
590        scope: rockchip
591
592        subsections:
593          - title: RK3399
594            scope: rk3399
595
596            deprecated:
597              - rockchip/rk3399
598              - rk3399/suspend
599
600          - title: RK3328
601            scope: rk3328
602
603      - title: Socionext
604        scope: socionext
605
606        subsections:
607          - title: Synquacer
608            scope: synquacer
609
610            deprecated:
611              - plat/synquacer
612
613      - title: ST
614        scope: st
615
616        deprecated:
617          - plat/st
618
619        subsections:
620          - title: STM32MP1
621            scope: stm32mp1
622
623            deprecated:
624              - plat/st/stm32mp1
625
626            subsections:
627              - title: STM32MP13
628                scope: stm32mp13
629
630              - title: STM32MP15
631                scope: stm32mp15
632
633          - title: STM32MP2
634            scope: stm32mp2
635
636      - title: Texas Instruments
637        scope: ti
638
639        subsections:
640          - title: K3
641            scope: k3
642
643            deprecated:
644              - ti-k3
645
646      - title: Xilinx
647        scope: xilinx
648
649        deprecated:
650          - plat/xilinx
651
652        subsections:
653          - title: DCC (Debug Communication Channel)
654            scope: dcc
655
656          - title: Versal
657            scope: versal
658
659            deprecated:
660              - plat/xilinx/versal/include
661              - plat/xilinx/versal
662              - plat/versal
663
664          - title: Versal NET
665            scope: versal-net
666
667            deprecated:
668              - versal_net
669
670          - title: ZynqMP
671            scope: zynqmp
672
673            deprecated:
674              - plat/zynqmp
675              - plat/xilinx/zynqmp
676
677      - title: Nuvoton
678        scope: nuvoton
679
680        subsections:
681          - title: npcm845x
682            scope: npcm845x
683
684  - title: Bootloader Images
685    scope: bl
686
687    deprecated:
688      - bl_common
689
690    subsections:
691      - title: BL1
692        scope: bl1
693
694      - title: BL2
695        scope: bl2
696
697      - title: BL31
698        scope: bl31
699
700      - title: BL32
701        scope: bl32
702
703        subsections:
704          - title: TSP
705            scope: tsp
706
707  - title: Services
708    scope: services
709
710    subsections:
711      - title: FF-A
712        scope: ff-a
713
714        deprecated:
715          - ffa
716
717      - title: RME
718        scope: rme
719
720        deprecated:
721          - rme/fid
722
723        subsections:
724          - title: TRP
725            scope: trp
726
727          - title: RMMD
728            scope: rmmd
729
730          - title: RMM
731            scope: rmm
732
733      - title: SPM
734        scope: spm
735
736        subsections:
737          - title: EL3 SPM
738            scope: el3-spm
739
740          - title: EL3 SPMC
741            scope: el3-spmc
742
743            deprecated:
744              - spmc
745
746          - title: SPMD
747            scope: spmd
748
749          - title: SPM MM
750            scope: spm-mm
751
752      - title: DRTM
753        scope: drtm
754
755      - title: TRNG
756        scope: trng
757
758      - title: ERRATA ABI
759        scope: errata-abi
760
761        deprecated:
762          - errata_abi
763
764      - title: ChromeOS
765        scope: cros
766
767  - title: Libraries
768    scope: lib
769
770    subsections:
771      - title: CPU Support
772        scope: cpus
773
774        deprecated:
775          - cpu
776          - errata
777          - errata_report
778
779      - title: EL3 Runtime
780        scope: el3-runtime
781
782        deprecated:
783          - el3_runtime
784
785        subsections:
786          - title: Context Management
787            scope: cm
788
789          - title: RAS
790            scope: ras
791
792      - title: FCONF
793        scope: fconf
794
795      - title: MPMM
796        scope: mpmm
797
798      - title: OP-TEE
799        scope: optee
800
801        deprecated:
802          - lib/optee
803
804      - title: PSCI
805        scope: psci
806
807      - title: ROMlib
808        scope: romlib
809
810      - title: GPT
811        scope: gpt
812
813        deprecated:
814          - gpt_rme
815
816      - title: SMCCC
817        scope: smccc
818
819      - title: Translation Tables
820        scope: xlat
821
822      - title: C Standard Library
823        scope: libc
824
825      - title: Locks
826        scope: locks
827
828      - title: PSA
829        scope: psa
830
831        deprecated:
832          - lib/psa
833
834      - title: DICE Protection Environment
835        scope: dice
836
837      - title: Context Management
838        scope: context-mgmt
839
840        deprecated:
841          - context mgmt
842
843      - title: Semihosting
844        scope: semihosting
845
846      - title: Firmware Handoff
847        scope: handoff
848
849      - title: Exception Handling Framework (EHF)
850        scope: ehf
851
852  - title: Drivers
853
854    subsections:
855      - title: Authentication
856        scope: auth
857
858        deprecated:
859          - driver/auth
860
861        subsections:
862          - title: CryptoCell-713
863            scope: cc-713
864
865          - title: Crypto
866            scope: crypto
867
868          - title: mbedTLS
869            scope: mbedtls
870
871          - title: mbedTLS-PSA
872            scope: mbedtls-psa
873
874      - title: Console
875        scope: console
876
877      - title: Generic Clock
878        scope: clk
879
880      - title: FWU
881        scope: fwu
882
883        deprecated:
884          - fwu_metadata
885
886      - title: I/O
887        scope: io
888
889        subsections:
890          - title: MTD
891            scope: mtd
892
893            deprecated:
894              - io_mtd
895
896      - title: Measured Boot
897        scope: measured-boot
898
899        deprecated:
900          - measured boot
901          - measured_boot
902
903      - title: MMC
904        scope: mmc
905
906        deprecated:
907          - drivers/mmc
908
909      - title: MTD
910        scope: mtd
911
912        deprecated:
913          - drivers/mtd
914
915        subsections:
916          - title: NAND
917            scope: nand
918
919            subsections:
920              - title: SPI NAND
921                scope: spi-nand
922
923                deprecated:
924                  - spi_nand
925
926      - title: GUID Partition Tables Support
927        scope: guid-partition
928
929        deprecated:
930          - partition
931
932      - title: SCMI
933        scope: scmi
934
935        deprecated:
936          - scmi_common
937          - drivers/scmi-msg
938          - scmi-msg
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: Renesas
1140        scope: renesas-drivers
1141
1142        subsections:
1143          - title: R-Car3
1144            scope: rcar3-drivers
1145
1146            deprecated:
1147              - drivers/rcar3
1148
1149      - title: ST
1150        scope: st-drivers
1151
1152        deprecated:
1153          - drivers/st
1154
1155        subsections:
1156          - title: BSEC
1157            scope: st-bsec
1158
1159          - title: Clock
1160            scope: st-clock
1161
1162            deprecated:
1163              - stm32mp_clk
1164              - drivers/st/clk
1165              - stm32mp1_clk
1166
1167          - title: Crypto
1168            scope: st-crypto
1169
1170          - title: DDR
1171            scope: st-ddr
1172
1173          - title: I/O
1174            scope: st-io-drivers
1175
1176            subsections:
1177              - title: STM32 Image
1178                scope: st-io-stm32image
1179
1180                deprecated:
1181                  - io-stm32image
1182                  - io_stm32image
1183
1184          - title: I2C
1185            scope: st-i2c
1186
1187          - title: FMC
1188            scope: st-fmc
1189
1190          - title: GPIO
1191            scope: st-gpio
1192
1193          - title: SDMMC2
1194            scope: st-sdmmc2
1195
1196            deprecated:
1197              - stm32_sdmmc2
1198
1199          - title: ST PMIC
1200            scope: st-pmic
1201
1202            deprecated:
1203              - drivers/st/pmic
1204
1205          - title: STPMIC1
1206            scope: stpmic1
1207
1208          - title: Regulator
1209            scope: st-regulator
1210
1211          - title: Reset
1212            scope: st-reset
1213
1214          - title: SPI
1215            scope: st-spi
1216
1217          - title: UART
1218            scope: st-uart
1219
1220            subsections:
1221              - title: STM32 Console
1222                scope: stm32-console
1223
1224                deprecated:
1225                  - stm32_console
1226
1227          - title: USB
1228            scope: st-usb
1229
1230            deprecated:
1231              - drivers/st/usb
1232
1233          - title: Watchdog
1234            scope: st-iwdg
1235
1236      - title: USB
1237        scope: usb
1238
1239        deprecated:
1240          - drivers/usb
1241
1242  - title: Miscellaneous
1243
1244    subsections:
1245      - title: AArch64
1246        scope: aarch64
1247
1248      - title: Debug
1249        scope: debug
1250
1251        deprecated:
1252          - common/debug
1253
1254      - title: CRC32
1255        scope: crc32
1256
1257        subsections:
1258          - title: Hardware CRC32
1259            scope: hw-crc32
1260
1261            deprecated:
1262              - hw_crc
1263              - hw_crc32
1264
1265          - title: Software CRC32
1266            scope: sw-crc32
1267
1268            deprecated:
1269              - sw_crc32
1270
1271      - title: DT Bindings
1272        scope: dt-bindings
1273
1274      - title: FDT Wrappers
1275        scope: fdt-wrappers
1276
1277      - title: FDTs
1278        scope: fdts
1279
1280        deprecated:
1281          - fdt
1282
1283        subsections:
1284          - title: Morello
1285            scope: morello-fdts
1286
1287            deprecated:
1288              - fdts/morello
1289
1290          - title: STM32MP1
1291            scope: stm32mp1-fdts
1292
1293            deprecated:
1294              - fdts stm32mp1
1295
1296            subsections:
1297              - title: STM32MP13
1298                scope: stm32mp13-fdts
1299
1300              - title: STM32MP15
1301                scope: stm32mp15-fdts
1302
1303          - title: STM32MP2
1304            scope: stm32mp2-fdts
1305
1306      - title: PIE
1307        scope: pie
1308
1309      - title: PIE/POR
1310        scope: pie/por
1311
1312      - title: Security
1313        scope: security
1314
1315      - title: SDEI
1316        scope: sdei
1317
1318      - title: TBBR
1319        scope: tbbr
1320
1321      - title: NXP
1322
1323        subsections:
1324          - title: OCRAM
1325            scope: nxp-ocram
1326
1327            deprecated:
1328              - nxp/common/ocram
1329
1330          - title: PSCI
1331            scope: nxp-psci
1332
1333            deprecated:
1334              - plat/nxp/common/psci
1335
1336      - title: UUID
1337        scope: uuid
1338
1339  - title: Documentation
1340    scope: docs
1341
1342    deprecated:
1343      - doc
1344
1345    subsections:
1346      - title: Changelog
1347        scope: changelog
1348
1349      - title: Commit Style
1350        scope: commit-style
1351
1352      - title: Contribution Guidelines
1353        scope: contributing
1354
1355        deprecated:
1356          - contribution-guidelines
1357          - docs-contributing.rst
1358
1359      - title: Maintainers
1360        scope: maintainers
1361
1362      - title: Prerequisites
1363        scope: prerequisites
1364
1365      - title: Threat Model
1366        scope: threat-model
1367
1368      - title: Porting Guide
1369        scope: porting
1370
1371  - title: Build System
1372    scope: build
1373
1374    deprecated:
1375      - makefile
1376      - Makefile
1377
1378    subsections:
1379      - title: Git Hooks
1380        scope: hooks
1381
1382        deprecated:
1383          - git-hooks
1384
1385  - title: Tools
1386
1387    subsections:
1388      - title: STM32 Image
1389        scope: stm32image
1390
1391        deprecated:
1392          - tools/stm32image
1393
1394      - title: NXP Tools
1395        scope: nxp-tools
1396
1397      - title: Firmware Image Package Tool
1398        scope: fiptool
1399
1400      - title: Secure Partition Tool
1401        scope: sptool
1402
1403      - title: Certificate Creation Tool
1404        scope: cert-create
1405
1406      - title: Memory Mapping Tool
1407        scope: memmap
1408
1409        deprecated:
1410          - cert_create
1411
1412      - title: Marvell Tools
1413        scope: marvell-tools
1414
1415  - title: Dependencies
1416    scope: deps
1417
1418    subsections:
1419      - title: checkpatch
1420        scope: checkpatch
1421
1422      - title: commitlint
1423        scope: commitlint
1424
1425      - title: Compiler runtime libraries
1426        scope: compiler-rt
1427
1428      - title: libfdt
1429        scope: libfdt
1430
1431      - title: Node Package Manager (NPM)
1432        scope: npm
1433
1434      - title: Poetry
1435        scope: poetry
1436
1437      - title: zlib
1438        scope: zlib
1439