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