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