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