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