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